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Course Description 


Purpose 


is designed to develop. skills in the configuration and 
customization of the Extended Services for OS/2 Communications 
Manager. 


Some consideration will also be given to the implementation of 
Extended Services for OS/2 Communications Manager in the 
enterprise environment. 


The class covers installation, configuration, and use of the Com- 
munications Manager lab sessions are included to reinforce the 
lectures. 


Course Topics 
e Lectures 


— Communications Manager Overview 
— Communications Manager Installation 
— 3270 Emulation 
— Communications Manager SNA Gateway 
— Communications Manager Workstation Profile and Local 
Node Characteristics 
— Advanced Configuration 
— SNA Data Link Controls 
— LAN Adapter and Protocol Support 
— APPC/APPN Overview 
— APPC Configuration 
— APPN End Node 
— APPN Network Node 
— 5250 Emulation 
— Asynchronous Communications/ASCII Emulation 
— Subsystem Management 
— Problem Determination 


e LAB Exercises 


— Extended Services for OS/2 Communications Manager 
Installation 
— 3270 Emulation Configuration (Token-Ring) 
— Communications Manager SNA Gateway (Token-Ring) 
— Advanced Configuration 
— APPC/APPN 
— APPN End Node 
— APPN Network Node 
— 5250 Emulation (Token-Ring) 
_ — Subsystem Management 
— Problem Determination 
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Audience 


Prerequisites 


Objectives 





2 Communications Manager 


This course is intended for technical support personnel respon- 
sible for planning, installation, user training and support for com- 
municating workstations in a networked environment. Since 
Communications Manager has a significant amount of function 
supporting IBM hosts, communications systems programmers are 
encouraged to attend with the PS/2 technical representative from 
their organization. 


Before taking this course, you should have taken the following 
courses (or have equivalent experience): 


e Fundamentals of SNA ($6593) 
¢ Token Ring Network Implementation and Management ($6767) 
¢ OS/2 2.0 Workstation Intermediate Workshop ($7048) 


After completing this course, you should be able to: 


— Identify the emulations and services that are available in the 
Communications Manager 


— Identify the communications media options available for 
specific Communications Manager features. 


— Identify the problem determination tools available in the 
Communications Manager. 


— Identify the subsystem management tools available in the 
Communications Manager. 


— Given the proper reference materials, install the Extended 
Services for OS/2 Communications Manager. 


— Given the proper reference materials, configure 3270. 


— Given the proper reference materials, configure the Commu- 
nications Manager SNA Gateway. 


— Given the proper reference materials, configure the Commu- 
nications Manager APPC service (Low Entry Networking). 


— Given the proper reference materials, configure the Commu- 
nications Manager APPN service to provide both End Node 
and Network Node capabilities to a system. 


— Given the proper reference materials, perform minor 
problem determination and resolution tasks using the Com- 
munications Manager 
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— Identify possible IBM support services which pertain to the 
Extended Services for OS/2 Communications Manager 


Curriculum Relationship 


This course is part of the OS/2 curriculum. While this course is 
specific to Extended Services for OS/2 Communications Manager, 
there are also courses available for the following topics: 


¢ Introduction to OS/2 
¢ Database Manager for Extended Services for OS/2 
e OS/2 LAN Services 


ee 
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Course Overview 


Agenda 


Day 1 


Day 2 


Day 3 


Day 4 


Introduction and Administrative Information 

Extended Services for OS/2 Communications Manager Introduction 
Installation and Configuration Tools 

Communications Manager Installation Lab 

3270 Emulation 

Using 3270 Emulation Lab 

SNA Gateway 

Communications Manager SNA Gateway Lab 


Workstation Profile and Auto-start Options 

SNA Configuration 

LAN Adapter and Protocol Support 

Advanced Configuration Lab 

Low Entry Networking 

Communications Manager LEN Node Configuration and Use Lab 


Advanced Peer to Peer Networking (APPN) 
Communications Manager APPN Configuration and Use Lab 
Advanced APPN Topics 

Advanced APPN Topics Lab 

5250 Work Station Feature 


5250 Work Station Feature Lab 
Asynchronous Communications 
Subsystem Management 
Subsystem Management Lab 
Problem Determination 


Problem Determination Lab 
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Materials Available to You 


Manuals You Should 


Have 


IBM Extended Services for OS/2 Start Here, S04G-1000 


IBM Extended Services for OS/2 Workstation Installation Guide, 
$04G-1008 


IBM Extended Services for OS/2 Hardware and Software Refer- 
ence, S04G-1014 


IBM Extended Services for OS/2 Guide to User Profile Manage- 
ment, S04G-1112 


IBM Extended Services for OS/2 Glossary, S04G-1019 


IBM Extended Services for OS/2 Messages and Error Recovery 
Guide, S04G-1017 


IBM Extended Services for OS/2 Productivity Enhancement 
Utility, 32G5668 


IBM Extended Services for OS/2 Communications Manager 
User's Guide, S04G-1015 


IBM Extended Services for OS/2 Keyboard Layouts, S04G-1018 


IBM Extended Services IBM Personal Computer Enhanced Key- 
board Template for Communications, S04G-1117 


IBM Extended Services for OS/2 Communications Manager 
Additional Functions Installation and Reference Guide., 
32G-5667 


IBM Extended Services for OS/2 Network Administration Guide, 
$04G-1001 


IBM Extended Services for OS/2 Communications Manager 
Configuration Guide, S04G-1001 


IBM Extended Services for OS/2 Programmable Configuration 
Reference, S04G-1003 


IBM Extended Services for OS/2 LAN Adapter and Protocol 
Support Configuration Guide, $046-1113 


IBM Extended Services for OS/2 Communications Manager 
Host Connection Reference, S04G-1004 


IBM Extended Services for OS/2 Example Scenarios, S04G-1005 


IBM Extended Services for OS/2 Problem Determination Guide 
for the Service Coordinator, S04G-1006 


IBM Extended Services for OS/2 Programming Services and 
Advanced Problem Determination for Communications, 
$04G-1007 
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Worksheets, SO04G-1111 


IBM Extended Services for OS/2 ACDI redirection Guide and 
Information, S04G-1024 


IBM Extended Services Service Point Application Router and 
Remote Operations Service Guide, S04G-1021 


IBM Extended Services for OS/2 Communications Manager 
Sample Programs, S04G-1021 


IBM Extended Services Command Reference, S04G-1020 
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Unit 1. Extended Services for OS/2 Communications 
Manager Introduction 


What This Unit is About 


This unit will provide you with a brief introduction to the features 
that are available in Extended Services for OS/2 Communications 
Manager. It is presented here to prepare you for what will be 
covered during the remainder of the week. 


What You Should Be Able to Do 


After completing this unit, you should be able to list the features 
that are available in the Extended Services for OS/2 Communi- 
cations Manager. 
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Communications Manager 


“Communications Manager provides services that your 
workstation can use to communicate with a host computer or 
with another workstation in order to exchange information 


or use the resources of that host or other workstation." 


OVRDEFN 


Visual 1-1. Communications Manager 


This rather broad description of Communications Manager really sums up the actual 
purpose of Communications Manager. What it doesn’t do is show the true power that 
is available within Communications Manager. 
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Communications Manager Features 


a Emulations 
gw Connectivity 
m Services 

w Management 


mg APis 


OVRFECHA 


Visual 1-2. Communications Manager Features 


The Extended Services for OS/2 Online Command Reference is automatically installed 
and is available, online, whenever any component of Extended Services for OS/2 is 
installed. The command reference contains a brief description and the syntax for 
commands that you can use for the Communications Manager, Database Manager, 
and User Profile Management components as well as the common installation, config- 
uration, and file compression utilities. 


API: Application Programming Interface 
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Emulations 


Ps 


3270 Terminals 5250 Terminals 


ASCII Terminals 


OVREMUL 


Visual 1-3. Emulations 





1-4 


The Communications Manager allows our workstation to perform like (emulate) a 
3270 display terminal, an ASCII terminal (such as a DEC VT100 or IBM 3101), and a 
5250 Workstation. 


Your workstation attached printer can emulate host printers as well. 


All of this can be done at the same time. You do not need to stop one emulation in 
order to use another. 


Some goodies include: 
— File transfer 

— Host graphics 

— Clipboard support 

— Multiple font support 
— Keyboard remapping 
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Connectivity 
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Vv 
COAX Y 
As 
eye 
CM, 


rn 
X.25 z 
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Visual 1-4. Connectivity 


Not all of the connectivity options are available to all of the features. For example, 
you cannot emulate a 3270 terminal over a Twinax connection. 


The supported LANS are: 


— Token-Ring 

— PC Network 

— Ethernet 

— {EEE 802.3 

— IBM 3174-Peer Communications Network 


SDLC: Synchronous Data Link Control 
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Services 


w APPC/APPN 
w SNA Gateway 
m X.25 Network Support 


gw Asynchronous Communications 


OVRSERV 


Visual 1-5. Services 


Services differ from emulators in the way you interact with them. While an emulator is 
typically interacted with directly, a service provides the ability to perform a particular 
type of communications. Once the ability is there, an application can do whatever it 
wants. For example, in order to use the 5250 emulator application, you must have the 
APPC service running. 


APPC: Advanced Program to Program Communications 


APPN: Advanced Peer to Peer Networking 
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APPN Networking 
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Visual 1-6. APPN Networking 


e APPN Networking allows a type 2.1 node to indirectly connect to another type 2.1 
node. This is accomplished by routing the connection through an intermediate 
node called a Network Node. All of this can be done without host involvement. 


¢ Once connected, the two nodes communicate using the LU 6.2 data stream. 
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SNA Gateway 






Token-Ring 
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Visual 1-7. SNA Gateway 


¢ The SNA Gateway allows multiple workstations to communicate with an SNA host. 
All of the workstation’s data is be routed through another workstation that is con- 


figured as a gateway. 
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Management 


w Subsystem Management 
w Problem Determination Tools 
gw Installation Tools 


w Configuration Utilities 


OVRMANA 


Visual 1-8. Management 


e Subsystem management allows you to view and control your communications. 
You can start and stop individual sessions, links, etc. 


¢ Several problem determination tools are available including: 


— Trace facility 

— Trace Formatter 

— Dump Facility 

— Error Logging 

— Message Logging 

— Management Services/NetView Alerts 

— FFST (First Failure Support Technology) 


Several tools are available to ease the installation task for the System Adminis- 
trator and the user. 


There are also several interfaces to Communications Manager configuration. 
These range from easy menu driven interfaces to an application programming 
interface for programmers. 
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Application Programming Interfaces 


m EHLLAPI mw ACDI 

= APPC w ACDI Redirection 
m= CPI-C mw SRPI 

gw NETBIOS mw X.25 

gw IEEE 802.2 gw LU Application 


a Subsystem Management's Programmable Configuration 


mw Common Services 
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Visual 1-9. Application Programming Interfaces 


APIs allow a programmer to write applications that will interface with Communi- 
cations Manager. They are function calls that save the programmer the effort of 
reinventing the wheel. 


All of the Communications Manager APIs support C and Macro Assembler lan- 
guages. 


In addition, the EHLLAP!, APPN, APPC, LU A, and SRPI APIs support COBOL. 
EHLLAPI also supports BASIC and REXX. 


e Each API supports a different protocol, which means a variety of hardware links is 
supported and many needs can be filled. 


EHLLAPI: Emulated High Level Language API 


APPC: Advanced Program to Program Communications 
CPI-C: Common Programming Interface for Communications 
NETBIOS: Network Basic Input Output System 

IEEE: Institute of Electronic and Electrical Engineers 

ACDI: Asynchronous Communications Device Interface 
SRPI: Server Requester Programming Interface 
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Extended Services Re-Packaging 


LAN Server 1.3 LAN Services 2.0 





Extended Services/2 





OS/2 SE 1.3/ 1.31 /2.0 
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Visual 1-10. Extended Services for OS/2 Re-Packaging 


e The extended applications of OS/2 Extended Edition have been separated from the 
base operating system. The LAN Requester is now bundled with the LAN Server 
in a product called LAN Services The Database Manager and Communications 
Manager have been bundled into a product called Extended Services for OS/2 
Both of these products will run on either OS/2 Version 1.30.1 or OS/2 Version 2.0. 
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Extended Services Product Objectives 


@ Enable OS/2 Communications and Database Manager 
to operate on selected IBM-Compatible systems 


@ Enhance the acceptance of IBM's SAA strategy by 
expanding the SAA workstation platform 


@ Help facilitate IBM's migration to a Client/Server Model 
for LAN offerings 


@ Provide IBM Service and Support for IBM code 
on non-IBM systems 


OVRPKGc2 


Visual 1-11. Extended Services for OS/2 Product Objectives 
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Extended Services Platform Support 


@ Support for OEM software and hardware platforms 
extends the scope of Extended Services 


@ Supported software 
' — OEM compatible Microsoft-based OS/2 Version 1.31 
— IBM OS/2 Version 1.30.1 and Version 2.0 


@ Supported hardware includes selected OEM PC hardware 
platforms running Microsoft's OS/2 Version 1.3 


OVRPKGos 


Visual 1-12. Extended Services for OS/2 Platform Support 
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Message Status Advanced Exit , Fl=Help 


Communications Manager Main Menu 


Active configuration file : 0S28664 
Configuration file status 
Verified 


Press F168 to go to the action bar or 
select an item below and press Enter. 


> 1. Start emulators (3276, 5258, and ASCII)... 
a 2. Stop emulators (3276, 5258, and ASCII)... 
« 3. Transfer file 

a 4. Specify new configuration file name default... 





Visual 1-13. Communications Manager Main Menu 





Fl=Help 


Message Status Advanced Exit 












« Keylock... 


Active configur . Subsystem management 
Configuration f 
Verified . Problem determination aids 


Press F168 to go . Configuration... 
select an item 





. Keyboard remap.. 
> 1. Start emul 
a 2. Stop emula . Upgrade configuration files.. 


s 3. Transfer f 


a 4. Specify ne 






Visual 1-14. Advanced Configuration 


e These two panels show the Communications Manager Main Menu and the 
Advanced pull- down. 


¢ Item four of the Advanced pull down (Configuration) is where we will be spending 
most of our time this week. 
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Unit 2. Installation and Configuration Tools 


What This Unit is About 


There are several tools available to both the system administrator 
and the end user to help with the tasks of installation and config- 
uration. These two tasks are very closely related as you cannot 
install Communications Manager without first configuring it. This 
unit will present the different tools that are available and provide 
information as to when each one should be used. 


What You Should Be Able to Do 


After completing this unit, you should be able to 


e List the tools available for installation of Communications 
Manager. 


e Use Basic Configuration Services to install Communications 
Manager. 


e Create a Custom Install Diskette. 


Reinstall a configuration file to add new features. 


¢ Use a Programmable Configuration exec to modify a configura- 
tion file. 


Understand when reinstallation is necessary. 


¢ Lock a Communications Manager configuration file. 


Print a report of configuration file profiles. 
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Configuration/Installation 





USERCFG1 
USERCFG2 
USERCFG3 
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Visual 2-1. Installation/Configuration 


¢ Communications Manager stores configuration information in five separate files. 
The files all have the same name but differ in their extension. 


.CFG: The main Communications Manager configuration file. It is stored in 
drive:\CMLIB\. 

-CF2: This is the file in which the SNA configuration information is stored. It is 
stored in drive:\CMLIB\APPN. 

-NDF: This is the ASCII text version of the .CF2 file. This file can be edited with an 
ASCII editor and then converted to the binary .CF2 file with verification. It is 
stored in drive:\CMLIB\APPN. 

-SEC: This is the file that stores SNA security information. It is stored in 
drive:\CMLIB\APPN. 

.INI: This file is used to store the LAN adapter and protocol information. The file 
you will actually use is called PROTOCOL.INI. It is a copy of your actual .INI in 
the same directory. Therse are ASCII text files that can be editied. It is stored in 


boot:\IBMCOM. 


e The configuration files are used to determine what Communications Manager fea- 
tures will be installed and used. The Communications Manager must be config- 


ured before it can be installed. 
e Only the configured features will be installed. This saves disk space. 


2-2 Communications Manager © Copyright IBM Corp. 1992 


Student Notebook 


Boot Drive Considerations 


Make sure there is room on your boot drive 
for the following components: 


mw The base operating system 

w User Profile Management (UPM) 

w LAN Adapter and Protocol Support 

gw First Failure Support Technology (FFST) 


w Extended Services Installation Utilities 
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Visual 2-2. Boot Drive Considerations 


e If you are using multi-boot capability of OS/2 Version 2.0 and plan to use Extended 
Services with more than one version of OS/2, you will need to install Extended Ser- 
vices twice. 


e In general, if you plan to use Extended Services for OS/2, your boot partition 
should be at least 50 MB. 

e You do not need to install the Communications Manager on the boot partition. 
These other components will be installed on the boot partition no matter where you 
install the Communications Manager. 


e See /BM Extended Services for OS/2 Hardware and Software Reference, S04G-1014 
for information on DASD requirements. 
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Base Operating System 


gw Be sure to install the following base operating system 
options: 


- INSTAID - The installation tool 

- ATTRIB - From the optional system utilities 

- KEYBOARD.DCP - The country information option 

- REXX - If you plan to use Programmable Configuration 


- VIEW - For viewing online documentation 


m These are all installed during a normal, default install. 


INSOVRO2 


Visual 2-3. Base Operating System 


e If VIEW is not listed as a separate option during the install process, then you just 
need to install one of the online documents in order to get it installed. 
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Installation 


w ESINST 
- Basic Configuration Services (BCS) 


- Custom Install Diskette 


- Advanced Installation 


gw REINST 
- Advanced Installation 


INSMETH 


Visual 2-4. Installation 


e ESINST is used for the first time installation. It resides on disk 1 of the Extended 
Services for OS/2 diskettes. To begin, type: BA TahY 


e lf you run ESINST after the first time install, any previous copies of Extended Ser- 
vices for OS/2 on the selected drive will be removed, and a new installation will 
begin. You will be warned of this fact. 


e REINST is used once the Extended Services for OS/2 has been installed to add and 
remove different features and components. 


The REINST program is really just like Advanced Installation. 


REINST can be invoked from the command line, or from within the Extended Ser- 
vices folder. 


If you are upgrading from a previous version, the upgrade will occur automatically 
during installation. 


Any previous versions of Communications Manager will be replaced during the 
upgrade. 


Previous configuration information will be preserved during the replacement, 
except when installation is done with a custom install diskette. 
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Basic Configuration Services 


= A prompted, menu driven interface to configuration file 
creation/modification 


au Configures and installs the most common connections 
and features 


= Uses default values to minimize the knowledge 
required to configure 


m Use when: 
- You do not have an existing configuration file 
- You do not have a Custom Install Diskette 


\ - You want a starting point for more extensive 
configuration 


- You wish to modify an existing BCS created 
configuration file 
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Visual 2-5. Basic Configuration Services 


e Any values that do not have defaults will only need to be provided once, and only 
if the feature you are configuring needs the value. 


¢ Some combinations of adapters/features are not allowed. For example: 


— No SNA Gateway configuration 

— No APPC configuration (except the APPC required for 5250) 
— No X.25 connections 

— Only one non-DFT adapter is supported. (LAN, SDLC, Twinax) 
— Only one 3270 or 5250 connection type is allowed 

— No ACDI redirection 

— Only one LAN type 


APPC: Advanced Program to Program Communications 
ACDI: Asynchronous Communications Device Interface 


DFT: Distributed Function Terminal 
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IBM Extended Services/2 Basic Configuration Services 


Select an option to create or change a Communications Manager 
Basic Configuration file. 
> 1. Create 
2. Change 


3. Create for another workstation 


4. Change for another workstation 


Esc=Cancel Fil=Help 
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Visual 2-6. Basic Configuration Services 


¢ This screen will not appear during the first time install with BCS. It will appear any 
time BCS is invoked after that. 


e¢ You cannot use BCS to change a configuration file if it has been modified with the 
advanced configuration function of Communications Manager. More on advanced 
configuration later. 


e You will not get the option to install the created or modified BCS file if you choose 
to create or change for another workstation. 
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Basic Configuration Services Main Menu 


Select a Communications Manager Basic Configuration feature 
that you want to create or change. 


. 3278 terminal emulation 

. ASCII terminal emulation 

. 5256 Work Station Feature (AS/466 host or $/36 Host) 
. Database Manager using Remote Data Services 


You will return to this menu for additional selections. 
Select F3=Exit when your last selection is complete. 


Esc=Cance] Fl=Help F3=€xit 
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Visual 2-7. Basic Configuration Services 


¢ Select the feature that you would like, one at a time. 
¢ Press F3=Exit to begin the install process. 


3276 Terminal Emulation Defaults 


Use the spacebar to change 3276 terminal emulation selections. 
An arrow is displayed next to the option when it is selected. 
Press Enter when you have completed all of the selections. 


Number of 3278 host sessions 1.22 
304 


3276 printer session 
No 


Start all sessions automatically 


Connection type 
eo LAN 


Enter Esc=Cancel Fl=Help 
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Visual 2-8. Basic Configuration Services 


e Fill out the parameters for the feature and press Enter to continue. 
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Advanced Installation 


w Install a user created configuration file 


w Install one or more of the provided default 
configuration files 


gw Install one or more of the Communications 
Manager additional features 


gw Install Database Manager on the workstation 


Visual 2-9. Advanced Installation 


© Copyright IBM Corp. 1992 Unit 2. Installation and Configuration Tools 2-9 


Student Notebook 


18M Extended Services/2 Install/Remove Menu 


Select an option. 


- Install Communications Manager 


. Install Database Manager 


. Remove Communications Manager 


- Remove Database Manager 


You will return to this menu for additional selections. 


Select F3=Exit when your last selection is complete. 


Fl=Help F3=€xit 
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Visual 2-10. Advanced Installation Install/Remove Menu 


¢ This is the main installation menu where you choose a particular component to 


install. 
¢ Note that Extended Services components can be removed as well. 


— Communications Manager allows you to selectively remove features just like 
you can selectively add them. 


Communications Manager Install Menu 


Select an option. 


> 1. Configuration files 


e 2. Additional features 


Select F3=€xit when your last selection is complete. 


Fl=Help F3=Exit 
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Visual 2-11. Communications Manager Install Menu 


We chose Communications Manager. 
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Communications Manager Configuration File Menu 


A configuration file is required to install Communications 
Manager. Select User configuration files to install a 
configuration file that has already been configured. 
Select Default configuration files if you do not have a 
configuration file. 


Select an option. 


> 1. User configuration files 


= 2. Default configuration files 


Enter Esc=Cancel Fi1=Help 
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Visual 2-12. Communications Manager Configuration File Menu 


There are two types of configuration file that can be installed: 


User configuration files: 
This is a file that has been previously created but has since had some new features 


added to it through the Communications Manager Advanced Configuration. It could 
also be a configuration file that was created at a different workstation. Installing a 
configuration file will also install any code necessary to support the features in the 
file. , 


Default configuration files: 
There are two default configuration files provided with Communications Manager. 
They are used as models for the creation of your own user configuration files. They 
contain model profiles to assist in filling configuring. 


ACSCFG.CFG: Contains keyboard profiles for all supported national languages. 
ACSCFGUS.CFG: Contains keyboard profiles for the United States only. 
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Source Location of Configuration Files 


The source location entered below will be used to display a 
list of user configuration files for installation. 


Enter to use the drive and directory displayed below or 
specify the correct drive and directory and Enter. 


Source drive and directory 
[C:\CMLIB 


Enter Esc=Cancel Fl=Help 
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Visual 2-13. Source Location of Configuration Files 


e¢ Only the drive and directory of the configuration files is specified. 


Select Configuration Files 


Use the spacebar to select one or more file names. An arrow is 
displayed next to the file name when it is selected. Press Enter 
when you have completed selections. 


File Name File Description 


aACSCFG Includes mode] profiles and all country keyboards 
aACSCFGUS Includes wodel profiles and country specific keyboards 


@ASYNCLAB BASIC CONFIGURATION FILe topic 8.1 
BENJAMIN BASIC CONFIGURATION FILE 

eLABSETUP Lab setup configuration file (a1 inclusive) 
aTEST BASIC CONFIGURATION FILE 


Enter Esc=Cancel Fl=Help 
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Visual 2-14. Select Configuration Files 


e This is a list of all the configuration files in the above directory. You may select 
multiple files if you wish. 





2-12 Communications Manager © Copyright IBM Corp. 1992 


logit 


Student Notebook 


Install Additional Features 


Use the spacebar to select one or more features. An arrow is 
displayed next to the feature when it is selected. Press Enter 
when you have completed selections. 


Installed 


Features Status 


Configuration services Yes 


Keyboard remap Yes 
ACDI Yes 
sACDI Redirection No 
eLAN Adapter and Protocol Support No 
sAPI data structures No 
eUtilities No 


Enter Esc=Cancel F1=Help 
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Visual 2-15. Install Additional Features 


e This shows the available additional features and their installed status. 
e You will not be able to select items that are already installed. 


e API data structures only need to be installed on a programmer’s system. They are 
the headers for the various programming languages. 


¢ Utilities will install several tools that help with installation, configuration, problem 
determination, and system management. They are: 


CMTRACE: Tool for tracing communications 
FMTRACE: Trace formatter 
COPYCFG: Gathers and copies all files for a given configuration file. 


DISPLAY: Displays a workstation’s SNA configuration. It can be used to 
display the configuration of a remote system if the remote system 
has installed the following tool. 


RDSPSRVR: Allows the display of workstation SNA configuration remotely. 
Programmable Configuration: REXXCUA configuration utility 
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Custom Install 


w Used to install a predetermined set of functionality 
onto a workstation. 


a All an end user will need to do is insert the Custom 
Install Diskette when prompted. 


g@ Any previously installed component will be completely 
removed before the custom install begins. 


a If users share a Custom Install Diskette, they will need to 
modify some values to assure uniqueness. 


ag Custom Install Diskette is created, in advance, by 
a System Administrator. 


Visual 2-16. Custom Installation 


e Custom Install Diskettes must first be created by the system administrator with the 
Custom Build Utility. 


The custom install diskette contains the answers to all the questions that the user 
would normally have to answer. 


Now the user doesn’t have do anything except enter diskettes. 


e When a custom install diskette is used, the following components will be installed 
automatically: 


— User Profile Management 
— First Failure Support Technology 
— Extended Services online reference 
— Extended Services install utilities 
¢ All other components must be specified in the custom installation diskette. 
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Installation/Configuration Tools 


wg Basic Configuration Services (BCS) 

gw Custom Build Utility 

mg Programmable Configuration 

mw Advanced Configuration 

w Keylock Facility 

w Configuration Upgrade 

w Configuration File Manager 

wp Copy Profiles from one CFG file to another 


gw View Install Logs 


Visual 2-17. Installation/Configuration Tools 


¢ You will be using advanced configuration all week. 
PATH: Main Menu--> Advanced--> Configuration 


¢ The configuration upgrade utility upgrades configuration files from previous Com- 
munications Manager versions. 


PATH: Main Menu--> Advanced--> Upgrade Configuration Files 


Copy Profiles allows you to copy profiles from one configuration file into another. 
This is good for combining the functions of two configuration files into a single file. 


PATH: Main Menu--> Advanced--> Configuration--> Configuration file Utilities 


e You can use VIEWLOG program to view the the install logs to see what has been 
installed, or what errors occurred. Invoke from the command line or from the 
Extended Services folder. 


The Configuration File Manager is a tool that provides assistance in copying con- 
figuration information to new configuration files or to diskettes. The tool will 
gather up all of the files that are needed for a configuration (CFG, NDF, CF2, SEC, 
INI) to make sure that they are all copied. The same tool can be used to move the 
files from diskette to their proper places in the new system. 
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Programmable Configuration 


gw Productivity aid for managing a large number of 
configuration files. 


a Create and modify multiple configuration files using a 
single REXXSAA program. 


@ You can use existing configuration files and profiles 
as templates for new configuration files. 


# A utility is provided to convert Extended Edition batch 
Configuration input files into Programmable Configuration 
REXXSAA programs. 


Visual 2-18. Programmable Configuration 


e Just about the only thing you can’t change with programmable configuration is 
keyboard remap. 


¢ The Programmable Configuration API can be used in application programs written 
in other programming languages. 


¢ The entire API is documented in /BM Extended Services for OS/2 Programmable 
Configuration Reference, S04G-1003 
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Programmable Configuration Example 


Begin the job 

= JOB (BEGIN, CFGFILE) 

Add a 3276 non DFT session a 
rc = 3276SNA (ADD, SESSION EQ 2, SESN_ID EQ SNA2) 


/* Add a 3276 DFT session */ 


re = 3276DFT (ADD, SESSION EQ 4, SESN_ID EQ DFT4) 


/* Verify the file */ 
re = FILE (VERIFY, CFGFILE) 

* End the job 

rc = JOB (END) 
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Visual 2-19. Programmable Configuration Example 


¢ This rather simple REXX exec will add a new 3270 non-DFT session and a new 
3270 DFT session to the configuration file called “CFGFILE”. 


¢ You can also use the power of REXX to prompt a user for values to be changed. 
e Use the looping capabilities to change multiple configuration files. 


e Notice that a file still has to be verified. 
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Custom Build Utility 


mw Used to create Custom Install Diskettes 


w Very easy to use, looks just like Advanced 
Installation 


p Writes installation information to diskette 
instead of installing 


w Actually stores configuration files onto the 
diskette along with the installation info. 


Visual 2-20. Custom Build Utility 
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Keylock 


Neal = 


4 Master Key 
Service Key 


INSLOCK 


Visual 2-21. Keylock Facility 


¢ The keylock facility allows you to protect a configuration file by locking it. 


Each configuration file is locked separately. 


If a file is locked, no changes can be made to the contents. The file contents can 
still be displayed, however. Passwords never display. 


If a file is unlocked, it can be changed. 


Keyboard remapping and color changes are not affected by the keylock. 


¢ Both keys will lock and unlock the file. The master key holder can change the 
master key or the service key, but the service key holder can only change the 
service key. Other than that, their powers are the same. 


PATH: Main Menu--> Advanced--> Keylock 
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Unit 3. 3270 Emulation 


What This Unit is About 


3270 emulation allows a workstation to behave as if it were a real 
3270 device. This allows a workstation to access a host system for 
3270 services. The emulation is handled through the software in 
the Extended Services for OS/2 Communications Manager. This 
unit will give an overview of the 3270 emulation features in the first 
topic. In the second topic, configurations concerns will be 


addressed. 


What You Should Be Able to Do 


After completing this unit, you should be able to 
e Describe the features of the 3270 emulation service. 
List the different connectivity options for 3270 emulation. 


Use the 3270 emulation feature. 


¢ Perform 3270 file transfer. 

¢ Perform 3270 keyboard remapping. 

¢ Configure 3270 emulation. 

¢ Install 3270 graphics support. 

e Use the clipboard for 3270 emulation. 
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Topic 3.1. 3270 Emulation Features 
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3270 Emulation 















Extended Services/2 
| Communications Manager 





Emulation Services 
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3270 Emulation Functions 





Terminal Physical Unit Printer 






Keyboard Remap File Transfer Graphics Display 





Visual 3-2. 3270 functions 


¢ Support is provided for up to ten 3270 sessions. A 3270 session can be either a 
terminal or a printer. The following devices are emulated: 


— Terminals 


— IBM 3178 Model C2 
— IBM 3278 Model 2-5 
— IBM 3279 Model S2B and S2B 


— Printers 
— IBM 3287 


e The physical unit functionality of a 3174 control unit is provided by the Extended 
Services for OS/2. 


The EHLLAPI API provides an interface between mainframes and personal com- 
puters with 3270 terminal emulation or 5250 WSF. An application written to this 
interface can read from and write to the terminal sessions just as if an operator 
was performing the function. 


The SRPI API is used to create SRPI clients (programs that request host servers to 
perform tasks). The SRPI server and requester operate in pairs, through a 3270 
terminal session. The requester resides in a workstation and the server resides in 
a host system. 
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3270 Emulation Connectivity 





3270 Emulation 






Cp fr 









Token-Ring 3174 


PC Network 





Visual 3-3. 3270 Connectivity 


¢ Up to five 3270 sessions can come from a COAX cable that supports DFT terminals. 
¢ Up to five 3270 sessions can come from another, NON-COAX, connection. 


Note: All of the NON-DFT (NON-COAX) 3270 sessions must come from the same 
connection type. 


The following connections are supported: 


¢ Through coaxial cable to a 3174 or 3274 terminal controller in DFT mode. The con- 
troller may be SNA or non-SNaA, local or remote. 

¢ Through coaxial cable to the 9370 workstation controller in DFT mode. 

e Over an SDLC line to a 3705, 3720, 3725, or 3745 Communications Controller or to 
the integrated controller on the 9370 workstation controller. 

e Through an IBM Token-Ring Adapter of a 3174, 3720, 3725, or 3745 controller or a 
9370 departmental system that acts as a gateway for OS/2 workstations. 

¢ Through an OS/2 workstation that serves as an SNA gateway to the host. 

e Over an X.25 connection to an appropriately programmed 9370 workstation con- 
troller or to a 37xx controller running on NPSI software. 


CUT Control Unit Terminal 

DFT Distributed Function Terminal 
NPSI NCP Packet Switching Interface 
NCP Network Control Program 
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3270 Sessions vs PM Sessions 





File 
—~| = Transfer 





Visual 3-4. 3270 Sessions vs. OS/2 sessions 


¢ Communications Manager operates as an OS/2 full screen application. 

¢ 3270 emulation runs as a single AVIO application in the Presentation Manager 
group. 

e All ten sessions actually belong to a single application. Thus you only lose one of 
your AVIO applications. 


¢ Each file transfer that is occurring, uses a separate OS/2 session. The session can 
be a PM AVIO windowed session or an OS/2 full screen session. 
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3270 Terminal Emulation 


| APPLNARE STATUS 


OAOannnnnnnann 
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02: 
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02: 
02: 
02: 
02: 
02: 


SSCCSSSSSBSS 
RIRBREBRERAE 
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Nes 


[Biers MAY ENTER IBMNET nodename TO ACCESS HOME US OFFICE SYSTEM 
PF7=Backward PFB=Forward 


H Enter area nare for connection or logoff to return or disconnect. 
TRAVELLI 
> 





Visual 3-5. 3270 Terminal Emulation 


e 3270 terminal emulation sessions reside within the Presentation Manager group. 
This allows them to: 
— Size, scroll, minimize and maximize the window. 
— Access the PM clipboard for data transfer. 
— Make use of the various AVIO font sizes. 
¢ The terminals all support the display of GDDM host graphics. 
e A screen print capability known as Presentation Space Print is available. 
All terminal keyboards and colors can be remapped. Each can have its own 
unique mapping. : 
Two APIs are available to interface with a 3270 terminal: SRPI, and EHLLAPI. 
e File transfer capability allows you to transfer files between the workstation and the 
host. 


AVIO Advanced Video Input Output 
API Application Programming Interface 


SRPI Server Requester Programming Interface 
EHLLAPI Emulated High Level Language API 





© Copyright IBM Corp. 1992 -Unit 3. 3270 Emulation 3-7 


Student Notebook 





PM Clipboard 
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Visual 3-6. PM Clipboard 


The clipboard allows a user to transfer data from one application to another. The clip- 
board is built in to the Presentation Manager. 3270 terminals can use the clipboard 
just like any other program. For example, you can compose a PROFS note in the 
OS/2 System Editor, copy the data to the clipboard, and then paste it into the 3270 
session. 


3270 terminals store data in the clipboard in three formats, the application that is 
being pasted into will determine which format to use. The formats are: 

Simple text Plain text and nothing else. 

AVIO Text and associated character attributes (ie. color) 


Bitmap Graphics images 


There are some restrictions: 


e You cannot CUT 3270 protected text. It can be copied though. 
e You cannot PASTE onto a 3270 protected area. A message will pop up warning you 


of the problem. 
¢ You can COPY host graphics to the clipboard (they are stored as bitmaps), but you 
cannot paste a bitmap into a 3270 session. 





3-8 Communications Manager © Copyright IBM Corp. 1992 


Student Notebook 


GDDM - OS/2 Link: Graphics Support 


COMPARISON 
OVER TIME 


NAILS 





1981 1982 1983 





=Help J-End 4=Print 11=Edit 12=Home 


Visual 3-7. GDDM-OS/2 Link: Graphics Support 


3270 terminal emulation supports GDDM host graphics. This support is provided by a 
separate product called GDDM-OS/2 Link. The following functions are supported: 


e View host graphics in all of your 3270 terminal sessions. 
e Print host graphics on workstation plotters and graphics printers. 
¢ Store host graphics files on the workstation as PIF files of PM metafiles. 


Each terminal can be customized for how graphics should be handled. Any changes 
made are stored in the OS2.INI file. You can control the following items: 


Retained Graphics: You can toggle this on or off. ON will cause a copy of the picture 
to be stored in the workstation so that refresh can be done quickly. This uses a 
significant amount of memory however. OFF will not save a copy of the picture on 
the workstation. The host will need to send a new copy of the picture if a refresh is 
required. This saves memory but slow host links will cause a lot of time delay as 
the picture is refreshed. 

Automatic naming of print jobs: This allows you to control the naming of print jobs. 
ON will automatically name them. You can control what the automatic name will be. 
OFF will prompt the user for a name each time a job is printed. 

PIF Picture Interchange Format. 
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Graphics: Installation vs. Operation 
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Visual 3-8. Graphics: Installation vs. Operation 


¢ The GDDM-OS/2 Link product is sold as a host tape. The tape is installed on the 
host and users will download it into the workstation to use. Once the code is 
installed on the workstation, the user can use host graphics on any host system 
with GDDM installed. The host does not need to have GDDM-OS/2 Link. 

e There is a fee for EACH workstation that installs the code. 

e The code is downloaded through a program in the workstation called HGINST. 
Before running HGINST, make sure you have logged on to the host system that has 
the GDDM-OS2 Link product. 

e When there are updates to the GDDM-OS/2 Link product, the updates are automat- 
ically sent to the workstation when a user tries to access GDDM on the host. This 
update can be canceled. 

e If you plan to print to workstation devices, you need to modify the host GDDM 
ADMDEFS PROFILE. Instructions are in the /BM Extended Services for OS/2 Com- 
munications Manager Configuration Guide, S04G-1001. 

e GDDM needs to be at V2.2 or greater and must have the following APARS: 

— MVS - PTF UL85607 

— VM/SP - PTF UL85608 

— XM/SP XA - PTF UL85609 
— VSE/ESA - PTF UL85610 
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3270 File Transfer 





INDSFILE 
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Visual 3-9. 3270 File Transfer 


There are two methods available: 


¢ Menu mode 
¢ Command prompt mode 


The menu mode uses a file transfer profile to hold the file transfer parameters. 
Several profiles can be created to address different file transfer situations (ie. Text vs. 
Binary). Profiles can also be temporarily changed for a unique situation. The change 
will not be saved in this case. 

Examples of Command prompt mode: 


C:\] SEND C:\DOC\MYFILE.TXT A:MYFILE SCRIPT A (ASCII CRLF 


C:\] RECEIVE C:\DOC\MYFILE.BIN D:MYFILE EXEBIN A 
Note: VSE/ESA file transfers must be done from the command line. 
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3270 Printer Emulation 





Operator initiated 






Printer 


Visual 3-10. 3270 Printer Emulation 


¢ Host directed print is the continuous printing of a data stream from a remote host 
to a local printer. This differs from the terminal presentation space print in that it 
will print more than a single screen full of data. 


e Printing can be host initiated or operator initiated. 


e Host directed printing requires a NAU to be configured at the host. This is an LU 
of type 1 or 3 associated with a PU. 
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3270 Print Control Panel 


pelect a session from the list, then select an action from the action 


pert Session igesion Type ueue rint 
A A 


Terminal PSCRIPT2 Available 
Terminal PSCRIPT2 





Visual 3-11. 3270 Print Control Panel 


The print control panel keeps you informed of the status of all printable items. This 
panel will appear whenever you have one or more printer sessions configured, or one 
or more terminals with presentation space print active. It provides the following: 


¢ Information on the print status of any print jobs 


— Job started 
Available 

— System error 

= Error 

PA1/PA2 pending 


¢ Configuration of print style and print options 


e Ability to cancel print jobs 
e Emulation of a 3287’s PA1 and PA2 keys 
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Topic 3.2. 3270 Emulation Configuration 


ss ee 
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Create/Change 32768 Profile 
> 1. Connection... DFT 
Not Configured 
Select Adapter Type 
# 1. 3278/79 emulation 


a 2. Advanced 3278/79 emulation... 
> 3. 3276 connection 


Esc=Cancel Fi1=Help 
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Visual 3-12. 3270 DFT Connection 


Communications Manager only supports one DFT (COAX) adapter. 


There are three different adapter choices for the DFT connection: 


3278/79 emulation: Used in a PC/AT bus workstation. The memory address cannot be 
changed and is fixed at hex ‘CE000’. 


Advanced 3278/79 emulation: Just like the 3278/79 emulation adapter, only you can 
change the address. Choose from the following: 


e CE000 
e DOO00N 
e D2000 
e¢ D4000 


3270 connection: The Microchannel adapter. The memory address is not changeable. 


Note: Connections over COAX must be as DFT (Distributed Function Terminal) 
devices. CUT (Control Unit Terminal) mode is not supported. 
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Create/Change 3276 DFT Logical Terminal Session Profile 


Use the spacebar to select. 


Session number 
Session ID 
Comment 


[ 
Short session ID 
AT keyboard profile name [ACS3ATUS] 
Enhanced keyboard profile name [ACS3ENUS] 
Presentation space size 
>» 25 x 86 (3278/79 mod 2) = 44 x 86 (3278/79 mod 4) 
# 33 x 86 (3278/79 mod 3) = 28 x 132 (3278/79 mod 5) 
« Other... 
Data transfer buffer size override (Kb) 
Unsupported control codes 
> Display hyphens 
Activate presentation space print 
> Yes 


Enter Esc=Cancel Fi=Help F4=List 
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Visual 3-13. 3270 DFT Terminal 


Session ID/LU name: Must be unique among all other LU names in the workstation. 
The first four characters will be placed in the sessions OIA (Operator Infor- 
mation Area). Can be used for file transfer. 

Short Session ID: Identifies the logical terminal. Must be unique among all session 
IDs, short session IDs, and all ASCII terminal emulation profile names. Can 
also be used for file transfer. 

Keyboard profile names: There is one for PC/AT keyboards and one for enhanced 
keyboards. If you do keyboard remapping, replace this with the name of 
your keyboard profile. 

Presentation space size: This is where you choose to be a model 2 or a model 3 etc... 
Other allows you to customize. However, many host applications do not 
work with customized values. 

Date transfer buffer size override: Range is 0 to 32 K. The value 0 causes Communi- 
cations Manager to calculate the value at runtime. It will use 12K for SNA 
devices and 7K for non SNA devices. Use 2K for CICS, back level INDSFILE, 
or if file transfer is not working. Large values improve file transfer times at 
the expense of overall system performance. 

Activate presentation space print: Set this to Yes if you want to do print screens. Turn 
this off in all sessions and you can get rid of the 3270 print control panel. 
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Create/Change 3276 DFT Logical Printer Session Profile 


Session number 
Session ID 


Short session ID 
Print buffer size 


Enter Esc=Cancel Fil=Help 
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Visual 3-14. 3270 DFT Printer 


Session ID and Short session ID mean the same thing for printers as they do for ter- 
minals. 


The Print buffer size specifies the buffer size for data that is transferred between the 
host and the workstation. The range is 1920 through 15300. Use the default of 1920 
unless you have special requirements. Make sure that the value is at least as large 
as the host mode table RUSIZES parameter or a bind failure can occur. 
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Create/Change 3276 Profile 


> 1. Connection... IBM Token-Ring Network 
Configured 
Specify Link Information 


Use the spacebar to select. 


Adapter number > Adapter 6 


a Adapter 1 


Destination address. .... - « « « . (4666867121691] 
Note: For ETHERAND, the aaivess format may need to be reversed. 
Press Fl for more information. 


Enter Esc=Cancel Fi1=Help 
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Visual 3-15. 3270 LAN Connection 


Adapter number If you only have one adapter, it will be adapter 0, not 1. Adapter 0 is 
the primary adapter. 


Destination address This is the address of the system you will be connecting to. It is 
your gateway to the host. This value is obtained from the person who configured 
the gateway device. 


The 3270 LAN connection is the same regardless of the LAN type. The only concern 
is when using an ETHERAND network to communicate with non IBM equipment or use 
universal addresses on you ETHERAND network. In this case, the address format 
may need to be reversed. 
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Create/Change 3276 Profile 
> 1. Connection... SOLC 
Not Configured 
Select SOLC Adapter 


> 1. Adapter 8 
a 2. Adapter 1 


Esc=Cancel Fl=Help 
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Visual 3-16. 3270 SDLC Connection 


e SDLC adapter number means the same thing as LAN adapter number. 


Create/Change 3278 Profile 


. Connection... X.25 
Configured 


« Session 1... Terminal 
. Session 2... Terminal 
. Session 3... Terminal 
. Session 4... Not Configured 
. Session 5... Not Configured 


Specify X.25 Information 


Directory entry name 


Enter Esc=Cancel Fl=Help F4=List 
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Visual 3-17. 3270 X.25 Connection 


e X.25 Directory entry name specifies the name of the X.25 directory entry that is 
associated with the host (remote DTE) with which you want to communicate. The 
remote directory entry must be configured in the X.25 feature profiles as well. 
More on this later. 
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Create/Change 3276 Logical Terminal Session Profile 


Use the spacebar to select. 


Session number 
Session ID/LU Name 


Short session ID 
AT keyboard profile name 
Enhanced keyboard profile name [ACS3ENUS] 
Presentation space size 
a 25 x 88 (3278/79 mod 2) = 44 x 88 (3278/79 mod 4) 
> 33 x 88 (3278/79 mod 3) a 28 x 132 (3278/79 mod 5) 
a Other... 
Data transfer buffer size override (Kb) 
LU local address (NAU hex address) 
Unsupported control codes 
> Display hyphens 
Activate presentation space print 
> Yes 


Enter Esc=Cancel Fi=Help F4=List 
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Visual 3-18. 3270 Non-DFT Terminal 


Create/Change 3276 Logical Printer Session Profile 


Session number 
Session ID/LU Name 


Enter Esc=Cancel Fl=Help 
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Visual 3-19. 3270 Non-DFT Printer 


The only difference between the DFT and non-DFT terminals and printers is the addi- 
tion of the LU local address (NAU hex address) field. This will need to match up with 
a VTAM LOCADDR parameter of an LU that is configured on your PU in VTAM. You 
cannot use the same value anywhere else in the workstation. 


NAU Network Addressable Unit 
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Color Reset Alarm Exit Fl=Help 


3276 Color and Alarm 







Select an item, then press F16 to select color. 






Field Attributes 





> Normal, Unprotected XOOOOOX KKK KKK 
= Intensified, Unprotected OXOQOOOO000OOO0OOOCOOOOKXX 
= Normal, Protected XOXQOQOOO0OOOOOOOXX KX XN 
= Intensified, Protected TOQOOO 0000000000000 
« Blue 1 0.0.0.0.6.0.0.0.0.0.000.00000000000) 
s Green D+.4.0.0.6.6.0.0.0.0000.0000000.0000) 
s Pink YOQOQOO000OOO00COOOOOOOXX 
a Red ; XXOQOOOOQOO0O0CO000000000NKX 
= Turquoise TOOQO0OO0OOOOO0OO00OO00OOKX 
s White OXOOOOO0O00OO0OOOOOOOOOXX 
« Yellow »00.0.0.0.0.0.0.0000000000000000) 
# Blink TOXOOQOO0000OO00OCOOOOXOX 
® Default Highlight YOO0QO0OOOO0COOOOOOOOO00NK 
= Default No Highlight OOQDOOO0OO00OO0000OO00OKX 
# Operator Information Area TOOQOOOOOOO00O00O00000O0MKX 
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Visual 3-20. 3270 Color and Alarm 


This panel allows you to change the visual and audible cues for a terminal session. 
This panel will only apply to one particular terminal session. You will need to con- 
figure this panel for each terminal you wish to modify. There are three type of alarms: 


Host alarm: Toggles a beep for when the host sends an alarm. 


Protect field alarm: Toggles a beep for when a user types into a protected text area. 


Screen update: Toggle a beep for when something changes in the terminal session 
and it is not the currently active OS/2 session. Just to let you know something hap- 


pened in the terminal session. 
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Create/Change VH Profile 





Use the spacebar to select. 


PROF TUS MAME eo. in ee Sve Ge es. He ive Sie ees we 


(MODEL PROFILE 3276 FILE TRANSFER 
ASCII to/from EBCDIC translation. .......2.ee- 
Use CR/LF as record separator .......2.2.+-+.ee-. 
PC file code page. . 2... ee ee eee eee een 
Host file code page... 2 2 2 eee ee ere ee een ee 
IBM host file transfer command 


Append to target file... 1... 2 2 eee ee eee 
Modify host file characteristics 

OPtiOns 2. c.g Boke ce eee Se ea SE oe we es a 
One-to-one character mapping. ..... 2.2. eee 


Enter Esc=Cancel Fil=Help F4=List 
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Visual 3-21. 3270 File Transfer 


ASCII to/from EBCDIC translation: Set this to No for BINARY file transfers and Yes 
(default) for text. 


Use CR/LF as record separator: Set this to no for BINARY file transfers and Yes 
(default) for text. 


PC file code page: Defines the ASCII code page to be used in ASCII to/from EBCDIC 
translation. It must reside in the CMLIB directory. 


Host file code page: Defines the EBCDIC code page to be used in ASCII to/from 
EBCDIC translation. It must reside in the CMLIB directory. 


Modify host file characteristics options: Setting this to Yes will bring up the following 
panel to allow changes to the host file characteristics. 


One-to-one character mapping: Each unmatched code page character sent is mapped 
to a unique character. This way, the file will transfer back in its original form. If you 
select No, the unmatched code page characters are all mapped to a specific set of 
characters. Two characters sent may map to the came character on the receiving 
end. This file may not transfer back in its original form. 
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Create/Change VM Profile 


Specify VM File Characteristics 


Use the spacebar to select. 


Logical record length 
Record format of host file. ......e- 
> Default « Variable 


a Fixed 


A 

Modify host file characteristics 
options 

One-to-one character mapping 
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Visual 3-22. 3270 File Transfer 





Student Notebook 


Logical record length: This entry specifies the logical record length, in characters, of 
the host file. When file transfer replaces or appends a file, the logical record length 
of the existing file is used. When you create a file with variable length records, the 
logical record length is the longest record in the file. The value 0 means to use the 


default value for host file record lengths (set at the host). 
Record format of host file: There are three ways to send the file: 
e Default - use the host default format (this is the default) 


e Fixed - If you choose fixed, the records in the file will all have the same length. 
¢ Variable - If you choose variable, the records in the host file will have variable 


lengths. 
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Keyboard Definition Utility 


- IBM 3161 ASCII terminal emulation... 

« VT166 ASCII terminal emulation... 

. IBM 3276 terminal emulation... 

- IBM 5256 Work Station Feature terminal emulation... 


Specify Comment Text 
Use the spacebar to select. 
[IBM Enhanced Keyboard - United States 
Change code page parameters 
s Yes... © No 
Numlock decimal separator » Period a Comma 


Numlock thousands separator »> Comma a Period = Space 


Enter Esc=Cancel Fl=Help 
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Visual 3-23. 3270 Keyboard Remap 


Swap Edit Deselect Display Exit | Fl=Help 


Action Panel: IBM Enhanced Keyboard 161 
22 EAE 00,8,0 .0,0,0,0 00,0 


o2,8,0,8,0,0,0,0,0,0,0,0,0,00 ,0,0,8 ,0,0,0,0 
28,080,880 8 0080 4, 0,8 a 
Fee hen ete hon ene of, 0,8, 

A 8 8 82222 afl anh 


ee COE, 


Use Enter to select a key(s); then use F168 to go to the action bar. 


Current Selection 


Shift . . : [NewLne] 
Base. . . : [NewLne] 
Alt. ..03 
Ctrl... 

Altér .. 
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Visual 3-24. 3270 Keyboard Remap 


Canadian users shouldn’t have any need to change the first panel. 


The first thing you need to do is select a key to edit. Click on a key with the mouse or 
use the cursor keys. If you use the cursor keys, don’t forget to use the space bar to 
select the key. 
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Swap Edit Deselect Display Exit | F1l=Help 


Action Panel: IBM Enhanced Keyboard 161 




















2, 8,0, 8, 0,0,0,0,0,0,0,0,0,8 ,8,.0,8 ,0,8,0,8 
M8, 8, 8,8, 8, 8,0, 0,0, 0,0, 0,0, a, 8,8 24,8 ,8, 
ft , 8, 0,88, 8, 8,8, 0,0, 0,5, 24, 8,8, 
0,0, 0, 00,000,000 8 8 8,888 








Edit Key Actions 









Use F2 to display the list of valid special characters 
Use F4 to display the list of valid functions 









Shift .. ([[NewLne] > 
Base. . . [[NewLne] > 
Alt... [ > 
Ctrl... [ > 
AltGr.. [ > 






Enter Esc=Cancel Fil=Help F2=Chars F4=Functions 
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Visual 3-25. 3270 Keyboard Remap 


There are five states of a key that can be mapped. If an area is greyed out, it means 
that the key combination is reserved and cannot be remapped. A total of 255 charac- 
ters can be assigned to a key. A grand total of 1024 characters can be assigned to a 


keyboard profile. A function counts as one character. You can mix functions and 


characters on the same key combination. 


¢ To assign a function to a key, enclose the function in square brackets. 


example: [Enter ]). 


for 


e You can also use the F4=list function to choose among the available functions. 


The square brackets will be added automatically in this case. 


¢ To assign a string to a key, enclose the string in double quotes. (for example: “This 


is a string”) 


¢ To assign a special character to a key, use the F2 key to list the special characters 


and then select the correct one. 


Note: Don’t forget to assign the new keyboard to your terminal sessions or it won’t 


be used. 
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Unit 4. SNA Gateway 


What This Unit is About 


A gateway permits communications between two networks that use 
different network architectures. Specifically, the OS/2 Systems 
Network Architecture (SNA) gateway allows supported work- 
stations to communicate with an SNA host. The Extended Services 
for OS/2 gateway is implemented by software that runs on any 
workstation supported by the Extended Services for OS/2 product. 
The SNA gateway is an efficient way to connect multiple work- 
stations to an IBM System/370 host through a shared host link. 


What You Should Be Able to Do 


After completing this unit, you should be able to 


e describe the capabilities of the Extended Services for OS/2 
gateway. 


e describe the connections that are supported by the Extended 
Services for OS/2 gateway. 


- © configure a gateway host connection profile. 


e configure a workstation connection profile. 
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Topic 4.1. SNA Gateway Features 


4-2 


Communications Manager 
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SNA Gateways 





Extended Services/2 
Communications Controller Communications Manager 





Personal Communications 3270 3174 Control Unit 


GATWAY01 


Visual 4-1. SNA gateways 


The Extended Services for OS/2 SNA gateway is not meant to be a replacement for 
other IBM gateway products, only an alternative. Each gateway has its own advan- 
tages and disadvantages. 
Several factors effect the performance of gateways. These include: 

e The gateway’s configuration 

e The gateway’s connection to the host 

¢ Overall demand on the host. 

¢ The gateway’s connections to the workstations. 

¢ The configuration of the workstation. 

e¢ The number of downstream workstations configured. 
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Extended Services Gateway Example 






Token-Ring 
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Visual 4-2. EXTD/2 Gateway Example 


e SNA LU types 1, 2, 3, and 6.2 are supported to a S/370 host. The LU 6.2 support is 
dependant LU 6.2 only (more on this later). 

e SNA LU types 1, 2, and 3 are supported to an AS/400 host, which can then act on 
the data or pass it on to an S/370 host. 

e The gateway is configured as a PU type 2.0 at the host side. 

e The downstream workstations think they are connected to a PU type 4 communi- 
cations controller. 

e When a downstream workstation is inactive, the gateway will implement the LU 
function. 

e When a downstream workstation comes online, the gateway gives control of the LU 
to the workstation. At this point, the workstation is doing all the work, and the 
gateway just passes data through. 

e The gateway does not perform any segmentation on the data; be aware of the fol- 
lowing: 

— The primary (host) send maximum RU size should not be greater than the gate- 
ways maximum RU size for the downstream workstation link (DLC). 

— The secondary (downstream workstation) send maximum RU size should not be 
greater than the gateways maximum RU size for the host link (DLC). 


Note: While you can connect to an AS/400, independent LU 6.2 is not supported so 
you cannot use the gateway for 5250 emulation. 
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Supported Workstations 





Personal 
Communications 






Token-Ring 






3270 WSP V 1.1 PC 3270 V 3.0 
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Visual 4-3. Supported Workstations 


The following downstream workstations are supported: 


PC DOS workstations running the PC 3270 Emulation Program, Version 3.0, con- 
nected over an IBM Token-Ring Network. 


PC DOS workstations running the 3270 Workstation Program Version 1.1, con- 
nected over an IBM Token-Ring Network. 


Workstations running the IBM OS/2 Extended Edition 1.0 (over a switched SDLC 
connection to the SNA gateway), 1.1, 1.2, 1.3 or Extended Services for OS/2. 


Note: IBM OS/2 Extended Edition Version 1.2, 1.3 or Extended Services for OS/2 
is required for connection over an ETHERAND network. 


PC DOS workstations running the Personal Communications/3270 program. 


Note: Personal Communications/3270 Version 1.01 and the IBM LAN Support 
Program Version 1.2 or later are required for connection to an SNA gateway over 
an ETHERAND Network. 


e PC DOS workstations running APPC/PC, Version 1.1, connected over an IBM 


Token-Ring Network, an IBM PC Network, or an SDLC switched connection. 
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Upstream Connections 






Token-Ring 
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Visual 4-4. Upstream Connections 


¢ Token-Ring 
e SDLC 
¢ X.25 (PSDN) 


While any one of the upstream connection type may be used, only one may used at a 
_time. If you wish to have more than one host destination, you will need to have mul- 
tiple configuration files. You will then need to start Communications Manager with the 


correct configuration file. 


Don’t forget the appropriate SNA DLC profile as well. 
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Downstream Connections 


X.25 EXTD/2 pe Neon 


Gateway 
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Visual 4-5. Downstream Connections 


¢ Token-Ring 

e PC Network 

e ETHERAND 

e SDLC 

e X.25 (PSDN) 

¢ The gateway can have a maximum of 254 LUs to distribute among its workstations. 
This is the maximum that can be defined for a PU at the host. 

e LAN connections support up to 256 workstations per adapter. 

¢ SDLC supports only switched connections to downstream workstations. One work- 
station at a time, per adapter. Configure all SDLC workstations the same. 

e X.25 supports 128 workstations. All 128 can use the gateway at the same time. 


Don’t forget the appropriate SNA DLC profile as well. 


Note: PC Network and ETHERAND are mutually exclusive in a workstation. There- 
fore, a gateway cannot support workstations on both networks concurrently. 
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Pooled LUs 






Token-Ring 


1 Session Active 
5 Sessions Configured 
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Visual 4-6. Pooled LUs 


¢ The gateway supports both pooled and dedicated LUs. 

e A dedicated LU is always reserved for a particular workstation. 

e Pooled LUs are shared among several workstations. 

¢ A workstation can have some of its LUs dedicated and some of them pooled. 


e The gateway can activate the link for a workstation with dedicated LUs, but not for 
a workstation with pooled LUs only. 


e When a workstation requests an LU from a pool and none are available, the work- 
station’s request is queued. 


¢ Pooled LUs are put into pool classes. Pool classes reserve LUs for certain work- 
stations. Workstations can only get LUs from the pools they are assigned to. 


¢ Pooling allows you to define more LUs to workstations than are actually available 
at the host. 


¢ The gateway will map an LU ID at a workstation to a real LU address at the host. 


4-8 Communications Manager © Copyright IBM Corp. 1992 


<) 





Topic 4.2. SNA Gateway Configuration 
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Create/Change SNA Gateway Host Connection Profile (1 of 2) 


Use the spacebar to select. 
DLC type... . 2. eee 
> SDLC... 
« IBM Token-Ring Network... 
a X.25... 
Permanent connection 


Auto-logoff timeout 
(minutes). ... 


Enter Esc=Cancel Fil=Help F8=Forward 
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Visual 4-7. Host Connection Profile part 1 


e Only one host connection profile can exist. 
¢ The connection type refers to the gateways connection to the host. 
¢ A permanent connection is not subject to congestion control. 


¢ The auto logoff time specifies the amount of time, in minutes, that an LU session 
can be idle before it will be logged off. 


e A pooled LU that is logged off by auto logoff will be returned to the pool. 


ee ls ge a ee es 
© Copyright IBM Corp. 1992 
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Pool 
Class 


[661 ] 


= 
@Q 
a 
i) 

ro" 


[661 ] 


Enter Esc=Cancel 





Create/Change SNA Gateway 


Host Connection Profile (2 of 2) 


LU Address 
Range (hex) 
(e2] - [66] 
[67] - [6A] 
[6B] - [@F] 
ee oe ae 
{]1-(C] 
ae ee ae | 
{]-[ ] 
[Peek J 
{]-[] 
{[]-[ ] 
L is J 
Plat 2 
{]-[C] 
{]-[ ] 
{]-[{ ] 
[]-[€ ] 


Fl=Help F7=Backward 


Auto-logoff 


(1 = Yes, 2 = No) 


C] 


¢ Pool classes are numbered from one to 254. 


e You can include the same number twice. 


contiguous LUs in a pool class. 


Student Notebook 


More: v 
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Visual 4-8. Host Connection Profile part 2 


This allows you to include non- 


¢ Specify the upper and lower limits of the LUs that you wish to have in the pool 


class. 


e If you use the same pool class number more than once, be sure you have specified 
the same auto-logoff value for all of that pool class. 
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Create/Change SNA Gateway Workstation LU Profile 







Use the spacebar to select. 
LU name at workstation .......4.4..4.42... : POOLED 


COMMON tise sa tes see Se eS 2 Aba ees Ths ay ee ee ew ere ee ae Rims 
[Pooled LU for workstation PU ES21TR6 LU address 62 ] 





PU name of workstation... ... 22 eee ee eae [ES21TR6 ] 


LU POOLING: oie ewe ce Se ee we te ale ES 

= Dedicated... 

> Pooled... 
LU local address 

at workstation (hex) . 2... 1 ee eee we wens [62] 
DLO: type: aoe ae Se te ah ee el a, AS eS 

« SDLC... > IBM Token-Ring Network... 

ao X.25... e IBM PC Network... 

= ETHERAND Network... 





Enter Esc=Cancel Fi1=Help 





GATCFG63 


Visual 4-9. Workstation Connection Profile part 1 


¢ A workstation connection profile must be created for each LU in each workstation 
that will be using the gateway. If a workstation will have five 3270 sessions, then 
five workstation connection profiles will need to be created in the gateway. 

¢ The workstation itself doesn’t need to do anything special to use the gateway. It is 
just like any other NON-DFT connection. 

¢ All workstation connection profiles must have unique names. In addition. the 
name must be unique among all other LU names in the gateway system. Some 
possible conflicts are: 
— APPC LUs 
— The gateway’s own 3270 logical terminals 
— SNA LUAs (LU 0) 


PU name of workstation: This parameter should contain the CP name of the down- 
stream workstation. This is not required, but recommended. This value will be 
included in NMVT alerts sent to the host. 


The LU local address: This is the address of an LU session that has been, or will be, 
configured at the downstream workstation. This value does not need to match any 
host LU values. The gateway will provide translation of this LU address to a real 
host LU address. 





4-12 Communications Manager © Copyright IBM Corp. 1992 


Student Notebook 


Create/Change SNA Gateway Workstation LU Profile 





Use the spacebar to select. 
LU name at workstation. .........2..... : POOLED 


Co Specify LU Pool Class 


] 
LU pool class 
(ES21TR6 ] 


PU 


LU; Enter Esc=Cancel Fl=Help 2 


> Pooled... 
LU local address 

at workstation (hex)... ....20.-. 002 eee [62] 
DLC type: ss 6 6 te ewe ee aD SE AOR 

= SOLC... > IBM Token-Ring Network.. 

a X.25... a IBM PC Network... 

a ETHERANO Network... 
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Visual 4-10. Workstation Connection Profile part 2(pooled LU) 











¢ For a pooled LU, all you do is specify which pool class to get the LU from. An LU 
can only belong to one pool class. 


Create/Change SNA Gateway Workstation LU Profile 
Specify Dedicated LU Parameters 


Us 
Use the spacebar to select. 


LU 
LU local address 
Co at host (hex). 2... 6... 2... ae { ] 
Auto-logoff. ... 2... 2. ee eee a Yes 
> No 








PU 
Enter Esc=Cancel Fl=Help 
LU 


> Dedicated... 





= Pooled... 
LU local address 

at workstation (hex). 2... ....02.-02000. [82] 
DEC ty Pe oo obs she. Fee el a een WS ee Ah es 

s SDLC... > IBM Token-Ring Network.. 

so X.25... a IBM PC Network... 


« ETHERAND Network... 
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Visual 4-11. Workstation Connection Profile part 2 (dedicated LU) 


¢ For dedicated LUs, you need to explicitly identify a host LU address. This must be 
unique among all LU addresses in the gateway system. 
¢ Dedicated LUs also have their own auto logoff parameter. 





© Copyright IBM Corp. 1992 Unit 4. SNA Gateway 4-13 


Student Notebook 














Create/Change SNA Gateway Workstation LU Profile 


Use the spacebar to select. 


LU name at workstation... ...++-«-ee.e«e.s. 2? POOLED 


Co Specify LU Pool Class ; 
| | 2 ] 


Specify Link Information 





Use the spacebar to select. 


Adapter number . . .» Adapter 6 
« Adapter 1 
Destination address . «.. . [466667171646] 
Note: For ETHERAND, the address format may need to be reversed. 
Press Fl for more information. 


Enter Esc=Cancel Fi=Help 
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Visual 4-12. Workstation Connection Profile part 3 


e The LAN destination address is the address of the downstream workstation in this 
case. Always use the address of where you are trying to go. 


¢ SDLC can only support a switched connection on the downstream side. Make sure 
that the SNA DLC profile is set accordingly. 


e X.25 will require an X.25 remote directory entry to be configured for the work- 
station. 
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Unit 5. Workstation Profile and Auto-start Options 


What This Unit is About 


This unit will cover the workstation profile and auto-start options of 
Communications Manager. The workstation profile and auto-start 
options contain global information about a user’s workstation. 
This information will be covered up front so that all other topics 
that reference this information will not need to repeat it. 


What You Should Be Able to Do 


After completing this unit, you should be able to 


¢ Define the purpose of the workstation profile and auto-start 
options. 


¢ Configure the workstation profile and auto-start options for a 
user. 


© Copyright IBM Corp. 1992 Unit 5. Workstation Profile and Auto-start Options 5-1 


Student Notebook 



























Change Workstation Profile 
Use the spacebar to select. 


COMMONTs: 5-6 ete ea oe ee te eee we) eo tele ws 

[BASIC CONFIGURATION FILE 
Machine type-model number. .......... =. (8576]- [668] 
Plant of manufacture- 


machine sequence number. ......... . . . [66]-[66ee666] 
Translation table file name. ......e.eeecee [ ] 
Error log file name. . 2... 1 2 2 eo we ww ww 

(ERROR. DAT J 


Error log size... ee ee ee ew ee we oe wo we 6 [16] K 
Error log overflow option. ........... > Wrap 


a Extend 

Message log. file name. ...... ae Soa eh 8, ewes 
[MESSAGE. DAT J 

Message log size..... Ss Se ch abate Tah Nese, Be =e [566 ] messages 
Message log overflow option. ....... . . . o> Wrap 

a Extend 
Display message pop-ups. ...... oe wa we oe ah Yes a No 
Enable auto-start options. .... ae necator ne eS > Yes a No 


Enter Esc=Cancel F1=Help 
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Visual 5-1. Workstation Profile 


e The machine type - model number, and plant of manufacture are used by Commu- 
nications & System Management (C & SM) alerts to identify individual workstations 
on the network. These items are required, but you can accept the defaults if you 
are not concerned with identifying workstations. Use the defaults for non-IBM 


computers. 


e Make sure that Enable auto-start options is set to yes if you wish to automatically 
start any services or emulators. 


Note: Services must be auto-started in order to be used. 
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Select Auto-Start Options 


Use the spacebar to select. 


Services to load. ...... SS es ae tele 


>» All configured services 
= Select desired services... 


Emulators to auto-start (one or more) . . 
« 3278 terminal emulation (DFT)... 
> 3278 terminal emulation (non-DFT)... 
« ASCII terminal emulation 
= 5256 Work Station Feature... 


= Communications Manager main menu 

= 3278 terminal emulation (DFT)... 

> 3278 terminal emulation (non-DFT)... 
«# ASCII terminal emulation 

= 52586 Work Station Feature... 


Enter Esc=Cancel F1=Help 





Visual 5-2. Auto-start Options 


¢ It is best to load All configured services. 


Display this screen first ....... a taal 


WKSCFG62 
Ne Tn ee et ee 
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Then, if they are configured, they will 


load. Otherwise, you can select the specific services you wish to load with Select 


desired services. 


Note: A service must be auto-started in order to be used. 


¢ You can. select multiple emulators to auto-start (ie. both 3270 DFT and 5250 emu- 
lation). You will specify the particular sessions to start in a follow-on panel. 
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Select Auto-Start Options 


Use the spacebar to select. 


Services to load. . 
« All configured services 
> Select desired services... 
Select Services to Load 

Use the spacebar to select. 
> SNA/APPC 
> SRPI 
>» X.25 
>» ACDI 
Enter Esc=Cancel Fil=Help 


= 5256 Work Station Feature... 


WKSCFG65 


Visual 5-3. Selecting Services to Load 





e This is how you would selectively load services. Just select the services you wish 


to load. 


¢ You will get an error when Communications Manager is started if you try to load a 


service that is not configured. 
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Select Auto-Start Options 










Select 3278 Terminal Emulation (non-DFT) Sessions to Auto-Start 


Use the spacebar to select one or more. 
Session Comment 


a--ALL-- 
PA 
>B 
aC 









Enter Esc=Cancel Fi1=Help 








=» 5256 Work Station Feature... 
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Visual 5-4. Selecting Sessions to Start 


e In this panel, you specify the specific sessions that you wish to have auto-started. 
e You do not have to start all of the sessions for a particular emulator. 


e If you plan to select specific sessions rather than all of them, make sure that you 
turn the “ALL” selection off or they will still all start. 


¢ You will have one of these panels for each of the emulators that you choose to 
auto-start. 
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Select Auto-Start Options 









Select 3278 Terminal Emulation (non-DFT) Session to Display First 











Session Comment 


>--ANY-- 
aA 
aB 














Esc=Cancel Fi1=Help 








ae ae ee 


=» 5256 Work Station Feature... 
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‘Visual 5-5. Selecting Session to Display First 


e In this panel, you specify the specific session that you want to be displayed first. 


e If you select “ANY”, Communications Manager will decide which session to display 
first. 


¢ You will have one of these panels for each of the emulators that you choose to 
auto-start. 
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Unit 6. SNA Configuration 


What This Unit is About 


This unit will deal with configuration of a workstation that will be 
doing SNA communications. Because several features of Commu- 
nications Manager will require that these items be configured, we 
will look at them now so that the information will not need to be 
constantly repeated. 


> The first topic will discuss the SNA Local Node Characteristics. 


ye ae The SNA local node characteristics contain the parameters needed 
‘ye to identify your workstation to the SNA network. 
Kb 
: The second topic will deal with SNA data link controls. SNA data 
link controls must be configured for any adapter you plan to use 
for SNA communications. If you are not using the adapter for SNA 
“ho communications, you do not need a DLC profile. The DLC profile 
; oP av provides an interface between the adapter in your workstation and 
Bes another system in an SNA network. 
U 
The possible DLC profiles are. 
e SDLC 
¢ Token-Ring 
e PC-Network 
¢ ETHERAND 
¢ Twinax 
e X.25 


SNA communications includes: 
¢ 3270 Emulation 
¢ 5250 Emulation 
¢ APPC communications 
¢ APPN networking 
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What You Should Be Able to Do 


After completing this unit, you should be able to 
¢ Configure the SNA Local Node Definitions for a workstation. 


¢ Configure each of the SNA Data Link Control types available to 
Extended Services for OS/2. You will also know where to go to 
get the matching partner parameters, when they are required. 
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Topic 6.1. SNA Local Node Characteristics 
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Local Node Characteristics 


Local Node Characteristics 


Additional SNA Features 
Connections 





SNALOCO1 


Visual 6-1. SNA Local Node Characteristics 


This will be the first panel you receive when you choose to update your SNA network. 
We are interested right now in the Local Node Characteristics. The key item to note 
here is that the SNA network configuration is a PM application, not the typical Com- 
munications Manager full screen. 


6-4 Communications Manager © Copyright IBM Corp. 1992 


Student Notebook 


Local Node Characteristics 


caAics* | 


/TAM PU 


nd Node - No Network Node Server 


/TAM 

DEF 

LR RELEV AT 
FoK SaQq7e 





SNALOCO2 


Visual 6-2. SNA Local Node Characteristics 


Network ID: An eight character name that identifies the network to which this machine 
is connected. This name will be used in error logs and alerts. 


Local Node Name: This is the actual name of this node. Each node in a network 
should have a unique name or problems can occur in certain types of communi- 
cations. Control point name. 


Node type: Identifies the type of node functions that this system will perform. There 
will be a much larger discussion of node types during the APPN lectures. 


Network node server address: This value identifies the address of your network node, 
if you are using one. It only applies if your network node is connected by Token- 


Ring or ETHERAND networks. 

Local node ID: This is the last five digits of an XID. It is used during link activation. 
For 3270 non-DFT emulation, this value should match IDNUM on your PU statement 
in VTAM. 


Local node alias name: This is just an alias for your node name. Another name you 
can be known by. If this is left blank, the local node name will be put here. 
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Topic 6.2. SNA Data Link Controls 


6-6 Communications Manager 
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Create/Change SDLC DLC Adapter Profile 

Use the spacebar to select. 
Adapter number. ...... 2. 2 eee eee 8 
Load DLC. . 2 2 ww ee we te tee te ee > Yes « No 
Free unused link. . . 2... ee ee eevee > Yes a No 
Maximum RU size . 1 1 ee ew we ew ee wee [6256] bytes 
Send window count... . «eee eevee [4] 
Receive window count. . . 2. « «ee ee eae [4] 
Line: type: sce 6 weed ee eee en es > Switched... 

= Non-switched 
Link station role... 2. 2. ee wee eevee = Secondary... 

; a Primary... 

> Negotiable... 

Line ode: 6-5 eae ea eae a fea ie ace 


> Line turnaround required 
« Constant request to send 
NRZDa 8. Sc aes a ci a a tas ee oe > Yes a No 
Modem rate. . 2. 2 2 ee we ww ee we wee > Full speed 
= Half speed 





Enter Esc=Cancel Fil=Help 





SNASDLC1 


Visual 6-3. SDLC DLC 


Free unused link Will bring down the link if it is not in use. This frees up resources. 
Select NO if: 


e A non-switched line is used. 

¢ Sessions are automatically activated. To avoid constantly activating and deacti- 
vating the link. 

e If SDLC DLC is used for 5250 Workstation Feature. 


Max RU size: The maximum RU that is supported by this adapter. It must be large 
enough to handle all RUs you wish to accept. Communications Manager will add 
nine bytes to this value to make up a packet information unit (PIU). If SDLC is used 
to talk to a host, the value must match MAXDATA - 9. 


Window counts: Number of I-frames that will be sent/received before waiting 
for/sending an acknowledgement. Depending on the host software version and 
release, they may need to match VTAM MAXOUT exactly. Defaults are good. For 
maximum performance, these can be increased to 7. 


Line mode: Indicated whether full duplex (Constant request to send) or half duplex 
(Line turnaround required) transmission facilities are in use. 


NRZI: Non Return Zero Inverted 
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Create/Change SDLC DLC Adapter Profile 
Use the spacebar to select. 
Adapter number : 6 


Load DLC. ...... sa .» Yes = No 
Free unused link. ... : -> Yes a No 


Maximum RU size... ewes - - [6256] bytes 
Send window count . . 

Receive window count. A - 

Line type. ..... ob tate -> Switched... 


Specify Data Set Timeout 


Data set ready timeout. . [5 ] minutes 


Enter Esc=Cancel Fi1=Help 


Modem rate... ce ee ee ww ww ee OP Full speed 
= Half speed 


SNASDLC2 





Visual 6-4. SDLC DLC 2 


Data Set Ready Timeout: specifies the maximum time, in minutes, that the DLC will 
wait for the data set ready (DSR) signal from the modem. This is only valid on 
switched lines. 


The default of 5 is good here. 
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Create/Change SDLC DLC Adapter Profile 
Use the spacebar to select. 


Adapter number. ..... way et ele pee a wy. 8 





Specify Negotiable Link Station Data 






Local station address (in hex)... . 2. 2 ee eee eae [61] 
XID repoll count. . 2. 2 2 ee ee ee we ee ew we we wn [16 ] 
Non-XID repoll count. .......e.. ieee 8 ewe aw (PE J 













Enter Esc=Cancel Fi1=Help 








« Primary... 
> Negotiable... 


Lime Modes... a te. 6 a we ee ee, Se 
> Line turnaround required 
= Constant request to send 
NRZ Tigo oe cat 8 Gar Sa eee: RE Bake ie Se 4B me > Yes a No 
Modem rate. .. 1... wee ba? Woe! een ee es > Full speed 
« Half speed 








SNASDLC3 
Na a se ee ee eee, 


Visual 6-5. SDLC DLC 3 


Local station address: Must be a different value from the partner station. For host 
communications, Match with PU ADDR in VTAM. This value only applies to a sec- 


ondary link station. 
XID Repoll count: Number of times the primary link station will send XID frames 


before initiating disconnection of the link. A value of 0 means to retry indefinitely. 
Recommendation is 10 for a switched line and 100 for a non switched line. 


Non-XID Repoll count: Number of times the primary link station will send Non-XID 
frames before initiating disconnection of the link. A value of 0 means to retry indefi- 
nitely. Recommendation is 10 for a switched line and 100 for a non switched line. 


XID frames are used during link initiation. Non-XID frames are used for all other data 
exchanges. 
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Create/Change IBM Token-Ring Network DLC Adapter Profile 


Use the spacebar to select. 





Adapter number... 1. 2 ee ee ee we we we ew ww ww : 6 
Load DEC te seinem as es ce! Sas ea Ses 6i > i) ee Hale cS ee > Yes 
a No 
Maximum number of link stations. . . 2. 1. 16 se ee ee eee [62] 
Percent of incoming calls. . . 1.2. 2. ee eee ee ee eee [656]% Ue 
pova ee 
Free unused link . 2 2 6 ew ee ee eee we ew ew we en > Yes ure Makcats | 
« No c 
Congestion tolerance... 1.2. 2 0 we ee ee ee ee een [686]% =F 
Maximum RU size. . 6 6 www we ee te ee te et [1624 ] bytes 
Send window count. . . 2. 2 eee ee ee ee te et te [2] —~___—_——+ Tam MAKOCT 
Receive window count... 1 2 eee ee ee ee eee ee [1] ——__——- ym cis 
CES PAN DS iio) a ole Os aC Re a ee [ }— + pTmm Pu 
Send alert for beaconing . . 2... 1 2 ese eee ee eae « Yes ( Bi 
> No ler lu or ese 
ft (é ‘arts = 


Enter Esc=Cancel Fi1=Help 





SNATRN61 


Visual 6-6. Token-Ring DLC 


Link Stations: One is required for every physical partner station that will use SNA for 
communications. Must be no larger than the link station value in the IEEE 802.2 
profile (more later). 


Percent of incoming calls: Percent of link stations that will be reserved for a partner 
station trying to contact you, rather that you contacting it. 


Congestion tolerance: When this percentage of link stations are allocated, the system 
will bring down links that are not in session. Only works if Free unused link is Yes 


ximum RU size: Must be at least large enough for any RU that may be received. 
gol not need to exactly match the host, just be large enough. 


C&SM LAN ID: Your LAN segment ID. It can be any value but a Network Adminis- 
trator may wish to assign it. Used for identification in alerts. 


Send alert for beaconing: Select Yes if you want this station to send an NMVT alert to 
the host when a beaconing condition exists on the ring. 
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Create/Change IBM PC Networks DLC Adapter Profile 


Use the space bar to select. 


Adapter NUNKEr 2.4 ek GK RHR eh ew ewe ee EF 
LGR DUG eis es a) on Re ae ew ha ee: eh kw > Yes 

a No 
Maximum number of link stations... .........2.4-. [62] 
Percent of incoming calls... 2... 6 1 2 ee eee eee es [e56]% 
Free unused Jivk 33646 2 ee ER ew RS we HOR > Yes 








Enter Esc=Cancel Fl=Help 





SNAPCN61 






Visual 6-7. PC Network DLC 





Create/Change ETHERANO Network DLC Adapter Profile 












Use the space bar to select. 





Adapter number...4 2.6.40 4.8 w 6.8 se eae ow age og FB 
Coad CLG ae es OS a ok Sy SoS, DRS. GM ow A > Yes 

a No 
Maximum number of link stations. .............. [62] 
Percent of incoming calls... ......-.-0240 000s (858]% 
Free unused link... 1 1. 6 ee ee ee ee ee > Yes 

a No 
Congestion tolerance... 1... ee eee ee ee ee eee [98e]% 
Maximum RU size. 2 6. [1624] bytes 
Send window count. . 6 6. 6 6 ee ee ee ee ee {2] 






Receive window count... 1... 2 2 ee ew ee ee ee we 








Enter EsceCancel Fl=Help 
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Visual 6-8. ETHERAND DLC 


The only difference between the Token-Ring DLC and the PC Network/ ETHERAND 
DLC is the alert parameter. The PC Network sends alerts for continuous carrier. The 


ETHERAND DLC does not send alerts 


The valid ranges for the parameters are generally smaller. 


Remember to use online help for valid ranges. 
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Create/Change Twinaxial DLC Adapter Profile 


Use the spacebar to select. 


Load DLC 
Maximum RU size 
Controller address a 64 


a 65 
s 66 


Adapter type 
> IBM System/36,38 Workstation Emulation Adapter/A 
« Enhanced 5256 Emulator Adapter... 


Enter Esc=Cancel F1=Help 


SNATWIN1 





Visual 6-9. Twinax DLC 


Controller address: This is the station device address. It must be unique for a given 
AS/400 twinaxial port. A maximum of 7 controllers can be attached to a given 
AS/400 twinaxial port. The valid range is 00 through 06. Each workstation attached 
to a port must use a unique controller address. 


Adapter type: While the Microchannel adapter is called IBM System/36, 38 Work- 
station Emulation Adapter/A, twinax is only supported to an AS/400. 


If the Enhanced 5250 Emulator Adapter is selected, you must also specify an |/O 
port, a hardware interrupt level, and a shared RAM location. 
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Create/Change X.25 DLC Profile 


Use the spacebar to select. 





Link profile name. . .. 2... eee oe ee ew ew ee © &)~6UNKNOWN 
Comment. ..... ais a) ape roe ces fo al fay fe nate a. er ta SS: Le Me 
] 

Load DLC ....... Sete RLS NE es alt coe ee ee ee > Yes = No 
Free unused connections. . . 2... 2 2 ee ee eee ewe > Yes a No 
Maximum RU size (bytes). ... 2... 2.2. ee ee we es = =6 [1824] 
Number of incoming connections ...... a iene, ay ecw OLS] 
Insert calling address in , 

call request packet. ....... oer Wie oe, “ert ene ve Yes a No 
Negotiate packet size. . 2. 2 2 2 ee eo ew wo oe ww ww oe VOUS > No 
Negotiate window size. . . 2. 1 2 ee ew we ww ww we ww oe VOUS > No 
Default link station role. ....... Nat inte Cre Taig 

« Secondary 

a Primary 

> Negotiable 
Default retry count. . 2. 2 2 ee eee eee we ee we [5 ] 
Default timeout (seconds). . 1... 2 ee ee ee eevee [268 ] 
Accept reverse charges . . . 2... 2 ee eevee . oe of Yes > No 
Enter Esc=Cancel F1=Help 

SNAX2561 








Nn a i ee 


Visual 6-10. X.25 DLC 


Link profile name: This is the name of a corresponding X.25 link profile. An X.25 DLC 
profile must be associated with an X.25 link profile. 


Free unused connections: Always select No if you are using Permanent Virtual Cir- 
cuits (PVCs). 

Default retry count: The number of times Qualified Logical Link Control (QLLC) com- 
mands will be retried. 


Default timeout: Time, in seconds, to wait for a response from issued Qualified Logical 
Link Control (QLLC) commands. 


Several parameters here must be coordinated with the network provider. Consult 
them for the correct values. 


e Insert calling address in call request packet 
¢ Negotiate packet size 
¢ Negotiate window size 
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Unit 7. LAN Adapter and Protocol Support 


What This Unit is About 


Communications on a Local Area Network (LAN) is rapidly 
becoming the standard method of communications, not just for 
LAN Server/Requester communications, but also for communi- 
cating to host systems. Extended Services/LS 2.0 provides a 
standardized method for communications over a LAN. This 
method is called the Network Driver Interface Specification (NDIS). 
NDIS makes it very easy to add LAN adapters and Protocols to the 
system. 


This unit will first introduce the NDIS and explain its operation. 
The second topic will be devoted to actual configuration of the 
LAN environment. 


What You Should Be Able to Do 


After completing this unit, you should be able to 


¢ Define the following terms, and give their purpose: NODIS, 
NETBIOS, IEEE 802.2, PROTOCOL.INI, Network Information File. 


e Describe the benefits of NDIS. 
e Identify the supported LAN adapters and protocols. 
¢ Configure LAN adapters and protocols for a system. 
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Topic 7.1. LAN Adapter and Protocol! Support Architecture 
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LAN Adapter and Protocol Support 


Token-Ring 





Visual 7-1. LAN Adapter and Protocol Support 


¢ The following LAN types are supported: 


— Token-Ring 
— Ethernet 

— IEEE 802.3 

— PC Network 


— LAN over COAX 
— Additional NDIS conforming adapter drivers may be installed at they becom 


available. 
e The following protocols: 
— NETBIOS 
— IEEE 802.2 
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LAN Adapter/Protocol Support Architecture 


| 
| 
NETBIOS/ 
NETBEUI 


— ee eee eee NDS 1.02 


Token ning PC Network re ntwot || ETHERAND |e n) omen omen 


LANOVRO2 


Visual 7-2. LAN Adapter and Protocol Support Architecture 


e Old (EE 1.3) IEEE 802.2 and NETBIOS are being replaced with new, performance 
oriented protocol stacks. 

e A new layer (NDIS) has been introduced that separates the hardware from the pro- 
tocol stacks. This allows new adapters to be supported without needing to change 
the protocol stack software. The adapter just needs to conform with the NDIS 
layer. 

¢ Support for new adapters will no longer be tied to an Extended Services/LS 2.0 
release. 

e New protocol stacks can be added in the same fashion. 

e NETBIOS is now separated from IEEE 802.2. This provides a significant perform- 
ance enhancement. This is different from EE 1.3 where the NETBIOS protocol fil- 
tered down through the IEEE 802.2 layer. 

e The IEEE 802.2 subsystem can determine the type of processor (80286, 80386/486) 
and optimize for it. 

e Up to 4 adapters are supported. 

¢ Communication Manager features are still limited to two adapters however. 


NDIS: Network Driver Interface Specification 
NETBIOS: Network Basic Input Output System 
IEEE: Institute of Electrical and Electronic Engineers 
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Network Driver Interface Specification 





1am | Protoco | [Protocol | OEM 
OO. NDIS 
IBM OEM 


LANOVROS 


Visual 7-3. NDIS 


¢ The 3COM/Microsoft LAN Manager Network Driver Interface Specification (NDIS) 
Version 1.02 provides a standardized method for communications between network 
adapter drivers and protocol drivers. 

Network adapter drivers: are device drivers that interface between NDIS and the 
actual. network adapter. They handle basic transmission and reception of 
packets on the network. 

Protocol drivers: are drivers that interface between NDIS and an application. They 
provide a high level of communications from the data link layer to the application 
layer. 

e NDIS is externalized from both the top and the bottom, this allows new adapters 
and protocols to be added and work with the existing system. For example, a new 
adapter can be added that will automatically be able to use the existing NETBIOS 
and IEEE 802.2 protocols. 


e LAN Adapter and Protocol Support requires that network adapter and protocol 
drivers conform to the NDIS Version 1.02 architecture. 
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NDIS Benefits 





Adapter Developer IBM Hardware/Software 

@ One driver for multiple PC platforms @ Large base of existing hardware 
and software 

@ Minimal development effort ® No changes to product to 
accomodate new hardware 

@ Supports existing OS/2 EE 1.2 @ Release Independent adapter 

and 1.3 adapters configuration/Installation 
LANOVRO4 


Visual 7-4. NDIS Benefits 


De-facto industry standard 
Multiple vendor support. Any vendor as long as they conform to NDIS. 


Take advantage of enhancements in adapter technology without waiting for a new 
Extended Services/LS 2.0 release. 


There will be conformance testing done on OEM device drivers to verify conform- 
ance with Extended Services/LS 2.0. This certification process ensures that the 
drivers/adapters are compliant with the NDIS architecture and that they operate 
correctly with Extended Services/LS 2.0. Drivers that have been certified will have 
an entry in their NIF file indicating that they have been tested with IBM NETBIOS 
and IBM IEEE 802.2. 


A non-certified adapter can still be installed. However, a warning will be pre- 
sented to the user during configuration indicating that the adapter has not been 
certified. The user may proceed and the adapter will be installed. 


A NON-CERTIFIED ADAPTER THAT IS NDIS COMPLIANT SHOULD STILL WORK. 


NIF: Network Information File 
LS 2.0: LAN Services Version 2.0 
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LAPS Configuration Architecture 


LS 
Config 


LAPS 


{ Configuration Utility ~ 


PROTOCOL 
NIF Files MAC Driver .INI 


Visual 7-5. LAN Transport Configuration Architecture 





LANOVROS 


The same LAN transport mechanism will be provided with both the Extended Ser- 
vices and the LS 2.0 products. 


e It is a common set of functions. 


It is capable of standalone operation. It is not required that you actually be 
running Extended Services or LS 2.0 in order to use the LAN transport facility. 


All configuration is done from the PM interface. If you are configuring from Com- 
munications Manager, the system will jump out of the EZVU session and bring up 
the PM interface. 


The configuration process uses a file, provided with the adapter, called a Network 
Information File (NIF). More later on this file. 


The output of the configuration is an updated PROTOCOL.INI file and an updated 
CONFIG.SYS file. PROTOCOL.INI is a file in the LAN transport directory that con- 
tains information that the various LAN device drivers use during initialization. 
CONFIG.SYS is updated with the required device driver information. 
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Network Information File 


w Template for PROTOCOL.INI entries 
w Contain adapter/protocol configuration information 
- @ Used to customize configuration of OEM adapters 


@ Created by the adapter developer 


LANOVRos 


Visual 7-6. Network Information File 


¢ This file is used by the configuration/installation program to dynamically build the 
PM configuration window. NIF file uses architected keywords that are understood 
by the configuration/installation program. 


e Each adapter/protocol will have its own unique parameters dialog based upon its 
NIF file. 


e NIF file contains specific information about each parameter: 


— context sensitive help info 
— allowable range of values for the parameter 
— default value for the parameter 


e A'NIF file is coded in ASCII text. 
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(atl ney ee ee ee ee 
| [PROT_MAN] 
DriverName = PROTMANS 





3 

[LANDD_nif] 

DriverName = LANDD$ 
Bindings = IBMTOK_nif 
NETADDRESS = 1466667171646 
ETHERAND TYPE = I 
SYSTEM_KEY = 6x6 
OPEN_OPTIONS = 6x2666 











TRACE = 6x8 
LINKS = 41 

HAX_SAPS = 4 

HAX_G SAPS = 6 

USERS = 4 

TI_TICK_G1 = 255 

T1_TICK_G1 = 15 

T2_TICK_G1 = 3 

TI_TICK G2 = 255 

T1_TICK G2 = 25 

T2_TICK_G2 = 16 

IPACKETS = 256 

UIPACKETS = 166 

HAXTRANSMITS = 6 

MINTRANSHITS = 2 

TCBS = 64 

GDTS = 36 

ELEMENTS = 868 

am at a inks Vw si ec cml snl in cla sclnv nda een ua te Smee al ete * 
een ee HAC SECTION Aaanosectniemtrn nance * 
We ee cicedwawekd SiS cowed belbeetewewedese en wceseceas * 





DriverName = IBMTOK$ 
MAXTRANSMITS = 6 
RECVBUFS = 2 
RECVBUFSIZE = 256 
XMITBUFS = 1 







Visual 7-7. PROTOCOLINI 


¢ The PROTOCOL.INI file is ASCII text and can be edited with any text editor. 
¢ The configuration/installation program will update this file with any parameter that 
you change. 


Note: While you can edit the PROTOCOL.INI with an editor, it is recommended that 
you use the configuration/installation program. The configuration/installation will 
provide you with useful information on the parameters that you wont get when editing 
the PROTOCOL.INI. Editing PROTOCOL.INI with an editor is best reserved for very 
quick, minor changes by experts. 
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LAN Over COAX 


LU 6.2 







3174 Peer Communications 


Program 
IEEE 802.2 


NETBIOS 


>< 
ba 
Z| 
= 


AC Driver 


LANOCXD1 


Visual 7-8. LAN Over COAX 


e LAN over COAX provides for routing LU 6.2, IEEE 802.2, and NETBIOS data, 
through a 3270 COAX adapter, to a 3174 control unit. 


e All of the COAX connected workstations and the 3174 become a single 3174-LAN 
segment. 


¢ The 3174-LAN segment can be bridged to another Token-Ring network. The bridge 
function is provided by the 3174 Peer Communications Program. 


¢ The 3174 Peer Communications Program provides the following three functions: 


Local peer to peer function: This allows COAX attached workstations to communi- 
cate with each other, through the 3174, without host involvement. (LU 6.2, IEEE 
802.2, and NETBIOS) 

Bridge function: This allows the 3174-LAN segment to communicate with work- 
stations on a Token-Ring network that is also attached to the control unit. 

Local Management function: Provides full management of the 3174-LAN segment 
via online tests at the control unit. 


e The NDIS XLN MAC driver emulates the function of an 802.5 (Token-Ring) MAC 
driver. It interfaces with the following adapters: 


— IBM 3270 Connection adapter (Microchannel) 
— IBM 3278/3279 Emulation adapter (PC/AT) 
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e A Maximum of 4 COAX adapters is supported in a Family 2 (Microchannel) system. 
¢ Only one COAX adapter can be used in a Family 1 (PC/AT) system. 


e In order to have 3270 DFT terminal emulation and LAN over COAX in use concur- 
rently, you must have at least 2 COAX adapters installed. Thus, you cannot con- 
currently use 3270 DFT terminal emulation and LAN over COAX in a Family 1 
system. 


3270 DFT terminal emulation will always use the lowest numbered adapter if it is 
available. 


e LAN over COAX will start at the highest numbered adapter and work downward ad 
subsequent adapters are used. 


Each COAX adapter will have its own device statement in CONFIG.SYS. 


e In addition to CONFIG.SYS, there will be entries for each COAX adapter in the 
PROTOCOL.INI file. 


MAC: Media Access Control 
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Topic 7.2. LAN Adapter and Protocol Support Configuration. 
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LAN Adapter/Protocol Configuration 


te: 
HIBM Token-Ring Network Adapters Bei BM IEEE 802.2 
{Western Digital EtherCard PLUS Adapters EY 
5 Ee =e 


0 - IBM IEEE 802.2 
0 - IBM OS/2 NETBIOS/NETBEUI 
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Visual 7-9. LAN Adapter/Protocol Configuration 


This is the main configuration/installation panel: 


e The upper left window will display all adapters for which NIF files were found. 
e The upper right window will display all protocols for which NIF files were found. 
¢ The bottom window will display the current system configuration. 
e¢ To add an adapter, select the adapter from the top window, and press the Add 
button. 
¢ To add a protocol: 
1. Select the adapter (from the current configuration window) you wish to add the 
protocol to 
2. Select the protocol you wish to add 
3. Press the Add button. 
e The number in front of a protocol identifies the adapter number that this protocol is 
installed on. It can be changed by pressing the Change Number button. 
e Edit the current adapters and protocols by selecting them and pressing the Edit 
button. 
¢ Remove an adapter or protocol by selecting it and pressing the Delete button. 


Note: The LAN Adapter and Protocol Support files will be installed in a directory 
structure beginning with IBMCOM on the BOOT drive of the system. 
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LAN Adapter Parameters 


Early release 

Primary adapter 
Alternate adapter 
Network adapter address 


Shared RAM address 


Maximum number of queued transmits 


Number of receive buffers 
Receive buffer size 


Number of adapter transmit buffers 
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Visual 7-10. LAN Adapter Parameters 


This is part of the edit option for a Token-Ring adapter: 


e The values displayed are obtained from the NIF file unless the value has been 
changed. Then, the value comes from the PROTOCOL.INI file. 


¢ Help is context sensitive for each parameter. 
¢ Range will give the allowable range of values for the particular parameter. 
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IEEE 802.2 Protocol Parameters 


¥Network adapter address 
*Type of Ethernet driver support 
*System key value 

xAdapter open options 

*802 trace level 

*Maximum link stations 


¥Maximum SAPS 


Maximum group SAPS 


¥Maximum number of users 


LANCFac3 


Visual 7-11. IEEE 802.2 Protocol Parameters 





This is part of the edit option for the IEEE 802.2 protocol: 


e Any parameter that is not preceded by an asterisk will change all instances of the 
protocol. If there is an asterisk, a change will only effect this particular instance of 


the protocol. 


© Copyright IBM Corp. 1992 


Unit 7. LAN Adapter and Protocol Support 





7-15 


Student Notebook 
a 


7-16 Communications Manager © Copyright IBM Corp. 1992 


Student Notebook 


Unit 8. Low Entry Networking 


What This Unit is About 


As terminals/workstations began to grow more powerful, the need 
for host involvement in communications between two stations 
became less important. The processors in todays workstations are 
powerful enough to handle all of the tasks required to initiate a 
communications session without the host. This is known as peer- 
to-peer communications. Low entry networking is the term used to 
describe the communications between two SNA nodes of type 2.1 
that use LU 6.2. This will serve as an introduction to the more 
powerful networking capabilities that are provided by Advanced 
Peer to Peer Networking (APPN). 


What You Should Be Able to Do 


After completing this unit, you should be able to 
¢ Define Logical Unit type 6.2. 
¢ Define SNA node type 2.1. 


¢ Configure Communications Manager to establish a LEN con- 
nection to another T2.1 node. 


¢ Configure a Transaction Program definition. 


e Describe a basic LU6.2 transaction program flow. 
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Topic 8.1. LU 6.2 
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What is LU 6.2? 


mw LU 6.2 is an SNA logical unit type specialized for 
distributed processing among peer programs. 


mw The LU 6.2 is a connection between a transaction 
program (TP) and the underlying network resources. 


mw LU 6.2 provides a formalized interface that 
transaction programs use to access network services. 


Transaction Program 





Interface 


Logical Unit 








Path Control Network 
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Visual 8-1. What is LU 6.2 


e It all begins with the need for two programs to share data between them. 


e LU 6.2 was developed to meet this need by allowing two LU 6.2s to establish a 
session between them and transfer data across that session. 


¢ Transaction programs actually communicate with each other. A transaction 
program is a program that is executed by or within LU 6.2 and does services 
related to the processing of a transaction. 

e An example of a transaction would be a request for a record from a database 
server. 
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Why use LU 6.2? 


w Well suited to program to program processing. 


Distributed files (e.g., DDM) 


File Transfer 


Network Management 


Office Communications 
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Visual 8-2. Why use LU 6.27 
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Why use LU 6.2? 


w The capability of terminals/workstations has 
changed dramatically. 


gw When SNA was first introduced, the capability of 
terminals was extremely limited compared to the host. 


- The host program was always the Primary logical unit (PLU). 
- The host was responsible for all session level error recovery. 
- Protocols were not symmetrical between PLU and SLU. 


- Relationship was Master-Slave. 


gw As distributed processors have increased in power 
and capability, LU 6.2 has been developed to exploit 
a peer to peer connection. 
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Visual 8-3. Why Use LU 6.2? 


LU 0 


e Program to program 
¢ Special purpose unarchitected protocols 
¢ 4700 finance terminals, JES2 NJE, HCF 


LU 1, 2, 3, 4,7 


¢ Program to device communications 
e Device dependent - data stream oriented 


LU 6.0, 6.1 


¢ Program to program between host LUs 
¢ CICS - CICS, CICS - IMS 

¢ Parallel sessions 

¢ Complex 


LU 6.2 
¢ General purpose program to program communications. 
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LU 6.2 Concepts 


@ Sessions: 
A session is a connection that permits a dialog 
between two logical units. 


@ Conversations: 
A conversation is a connection, across a session, 
that allows a dialog between two transaction programs. 


@ Protocol Boundary: 
A protocol boundary governs the rules of a 
conversation. 


APCOVROS 


Visual 8-4. LU 6.2 Concepts 


e Every LU in a network must have a unique name. This name is how the LUs find 
each other to communicate. 
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Sessions 
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Visual 8-5. Sessions 


¢ Session connect logical units 


An LU 6.2 session is a serially reusable resource. When one transaction program 
is finished with it, the session is available for another transaction program. 


A single LU 6.2 can have several session active at the same time. The sessions 
can be to different partner LUs, the same partner LU, or both. 


e When you have more than one session to the same partner LU, it is known as par- 
allel sessions. 


e Session security is available to verify that a session is allowed between two LUs. 
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Conversations 
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Conversation 







Visual 8-6. Conversations 


Conversations connect two transaction programs. 
A conversation permits two transaction programs to maintain a dialog. 


The conversation can only send data one direction at a time. That is, when one 
side is in send state, the other side must be in receive state. 


Transaction programs see only the conversation. The Transaction program does 
not see or need to be concerned with session protocols. 


Conversation security is available to verify an end user’s authorization to run a 
particular transaction program. 


A session can have only one conversation at a time. 
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Visual 8-7. LU Protocol Boundary 


¢ The protocol boundary is a formalized interface between the transaction program 
and the logical unit. 


¢ The protocol boundary permits an application to be developed independently of 
the underlying communications facility. 


e When application programs are written with an SAA compliant programming lan- 
guage, the protocol boundary provides for transparent porting of an application 
across SAA platforms. 
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Visual 8-8. LU 6.2 Services 


8-10 


Communications Manager 


LU 6.2 Services 


gw Session Services 
w Conversation Support 
gw Synchronization Support 


w Outage Notification 
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Session Services 


w Allocation of sessions between LUs for programs to 
converse over. 


@ Sessions are selected based on a particular MODE 
of communications. | 


- Synchronization level 
- Security support 
- Class of service 


- Maximum RU size 


@ LU identification and verification. 
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Visual 8-9. Session Services 


e When a session is established, a mode is used to set the characteristics of that 
session. 


e In LU 6.2 all BINDS are negotiable, thus the BIND sent by the session requestor 
can be accepted, rejected, or modified by the destination session. 


e An identical MODE name is required at both ends. The contents of these modes 
do not have to be the same though. 


* Several modes are architected and come with most LU 6.2 implementations. 


Default Used when no mode is explicitly specified also known as BLANK. 
#BATCH For batch types of transactions ; 
#INTER For interactive types of transactions 

#BATCHSC Batch with security 

#INTERSC Interactive with security 

CPSVCMG For CP - CP sessions 

SNASVCMG For service transaction programs managing parallel sessions. 
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Conversation Support 
w Remote program selection and startup. 
w User identification and verification. 
w Half duplex flip-flop communications. 
w Multiple concurrent conversations. 
mw Any data stream support. 


w Data mapping. 
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Visual 8-10. Conversation Support 


¢ Transaction program conversations are mapped to sessions via brackets and the 
SNA Function Management Header 5 (FMEH-5). 


e A remote program is specified during the allocation of a conversation. That 
program can then be executed at the remote system. In Communications 
Manager, an application called the Attach Manager is responsible for handling the 
remote program execution. It is also used for security validation. 


¢ Half-Duplex flip flop communications means that data can only be sent in one 
direction at a time. 
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Synchronization Support 


gw Program synchronization. (Similar to WAIT/POST) 


w Commitment Control (SYNCPOINT). 
eg Attention Mechanism. 


gw Error notification. 
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Visual 8-11. Synchronization Support 


¢ SYNCPOINT/BACKOUT verbs allow complex database services in which a logical 
unit of work can be committed or backed out. 


e Either end of a conversation can report an error. The transaction that is in receive 
state reports an error by sending a negative response (-RSP) to data sent. The 
sender will turn the line around at that point. 
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LU 6.2 Verb Support 


= Basic Conversation Verbs. 
Intended for use by service transaction programs. 
Requires the programmer to construct the General 
Data Stream (GDS) records, including the record 
length and the GDS ID. 


u Mapped Conversation Verbs. 
Shield the transaction programmer from the 
complexities of the basic conversation. In particular, 
the building of the GDS length and ID fields. 


The user has no knowledge of the GDS header and 
the data passed to and from the LU 6.2 API is simply 
user data. 
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Visual 8-12. LU 6.2 Verb Support 


e There are also some type independent verbs that can be used regardless of the 
conversation type. 


¢ Control Operator Verbs exist to define and control LUs and sessions. 
¢ A conversation can be in one of several states. 
Reset A conversation can be allocated by the transaction program. 
Send A Transaction program can send data or request confirmation. 
Receive A program can receive data 
Confirm Program can reply to confirmation requests. 
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Transaction Program A 


ALLOCATE 
TPN (B) 
LU-NAME (OTHER(SYSB)) 
MODE-NAHE (HODE1) 
SYNC-LEVEL (NONE) 
RETURN-CONTROL 

(WHEN-SESSION-ALLOCATED) 

RESOURCE (rscid) 





SEND-DATA 
RESOURCE (rscid) 
DATA (buffer) 


RESOURCE (rscid) 
DATA (buffer) 








WHAT-RECEIVED (DATA) 


RECEIVE-AND-WAIT 
RESOURCE (rscid) 
DATA (buffer) 
WHAT-RECEIVED (DEALLOC) 


DEALLOCATE 
RESOURCE (rscid) 
TYPE (LOCAL) 


Visual 8-13. Example Flow 


RECEIVE-AND-WAIT = -------------------- 


Example Flow 
Yr eg EE Ee Ne gp ee ee ee 


Transaction Program B 


(LU 'SYSB' receives 
FMH-5 and starts TPB) 


RECEIVE-AND-WAIT 
RESOURCE (conv1) 
DATA (area) 

WHAT -RECEIVED 
(DATA-COMPLETE) 


RECEIVE-AND-WAIT 
RESOURCE (conv1) 
DATA (area) 
WHAT-RECEIVED 

(SEND) 
RETURN-CODE (0K) 


SEND-DATA 
RESOURCE (conv1) 
DATA (area) 


DEALLOCATE 
RESOURCE (conv1) 
TYPE (SYNC-LEVEL) 


Student Notebook 









¢ Note that data does not actually flow until a buffer is full or a verb that causes a 
buffer flush is issued. Receive-And-Wait is just such a verb. 
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LU 6.2 APIs 


There are two APIs available for writing LU 6.2 
applications: 


a CPI-C 
This is the SAA implementation of LU 6.2. By using 
this API and following the guidelines of SAA, you 
can develop applications which are easily integrated 
and made to run on any SAA hardware and software 
environment. 


gm APPC 
APPC implementations are product specific. The 
APPC for the AS/400 is not the same as the APPC 
for OS/2. 


APCOVR20 


Visual 8-14. LU 6.2 APis 


e With two exceptions, you do not need to consider the API used in the partner 
transaction program when choosing the API! you will use. 
— CPI communications does not support the sending or receiving of Program 
Initialization Parameter (PIP) data. 
— CPI communications does not provide the equivalent value of Locks parameter 
on the [MC_]PREPARE_TO_RECEIVE verb. 
e If you need to run the application in other SAA environments, choose the CPI-C 
API. 
¢ To minimize the OS/2 programming skills required, choose CPI-C. 
¢ To develop an application that can accept multiple conversations in the same 
process, choose APPC. 
e To develop an application that starts multiple TPs in the same process, choose 
APPC. 
¢ To develop applications where more than one process will use the same TP, 
choose APPC. 
¢ To optimize for performance, choose APPC. The APPC API is optimized for OS/2. 
It incurs less overhead than CPI-C calls. 


Note: Regardless of the API chosen, there are no restrictions on the number of con- 
versations allocated. However, the CPI-C calls do not permit a single process to 
accept multiple conversations. 
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SNA Node Type 2.1 


uw Designed to permit the establishment and management 
of logical unit type 6.2 sessions. 


Without host involvement. 
Between adjacent peer processors. 


u This facilitates any-to-any, peer-to-peer connectivity 
and enhances the number and scope of LU-LU 
sessions supported. 


= Supports both Dependent and Independent 
logical units. 
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Visual 8-15. SNA Node Type 2.1 


¢ The T2.1 node eliminates hierarchical control. 
e Peer processors can dynamically negotiate network roles. 


e Reduces user coded definitions. 
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Dependent LUs 


w Logical unit types 0, 1, 2, 3, 4, 6, and 7 

w Typically attached to PU type 2.0 nodes. 

w Require an SSCP-LU session for session control. 
gw Limited toa single concurrent LU-LU session. 

w Can serve as secondary logical units only. 


mw Cannot communicate with another dependent LU 
without an intermediate host primary LU. 


APCOVRI4 


Visual 8-16. Dependent LUs 


e LU 0 can support peer-to-peer (PU 5 to PU 5) sessions, establish multiple concur- 
rent sessions between the same session partners, and assume either primary or 
secondary session roles. It is still, however, dependent on an SSCP - LU session 
for session establishment and control. 


e LU 6.2 sessions can exist in a PU 2.0 node, but they will be dependent LUs. 
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Independent LUs 


w Logical unit type 6.2. 
w SNA Node Type 2.1. 


w Can initiate LU-LU sessions (send a BIND) 
without SSCP mediation. 


w Supports multiple concurrent sessions. 


w Supports multiple sessions to the same partner LU. 
(Parallel Sessions) 
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Visual 8-17. Independent LUs 


e An independent LU can be either primary or secondary LU. The primary LU is the 
LU that sends the BIND and is typically the first speaker on the session. 

e A secondary LU can send a BID for a session so that they can allocate a conversa- 
tion on the session. 

¢ The BID process takes additional time, so a slight performance gain can be real- 
ized by making sure that the Primary LU is usually the one that needs to allocate 
conversations. 
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Node Type 2.1 Connectivity 


m There are three types of connections that a T2.1 node 
can make to other SNA nodes: 


- As a peer node involved in a direct connection 
to another T2.1 node. 


- As a peripheral node to a T4 or T5 subarea node 
providing PU 2.0 boundary function support. 


- As a peripheral node to a T4 or T5 subarea node 
providing T2.1 boundary function support. 
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Visual 8-18. Node Type 2.1 Connectivity 


¢ T2.1 nodes support links to more than one adjacent node. 


¢ The link station role (primary vs secondary) can be negotiated during link acti- 
vation. 
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Network Accessible Unit 


= One component of the architecture that addresses the 
top four layers of SNA. 


mw There are three NAU types for T2.1 nodes: 


Control Point 
Logical Unit 
Intermediate session routing 
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Visual 8-19. Network Accessible Unit 


e Note that what was once a Network Addressable Unit is now a Network Accessible 
Unit. This is because LU names are mapped to their corresponding Control point 
and link. LUs are not identified with addresses in this scenario. 





8-22 Communications Manaaer © Copyright IBM Corp. 1992 


Student Notebook 


LEN Node Configuration 


APCCFG1O0 


mw Local Node Characteristics 

w Peer Connections 

gw Partner LUs 

mg Transaction Program Definitions 
w Local LUs 


w Modes 


Visual 8-21. LEN Node Configuration 
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SNA Local Node Characteristics 


0S28064 


sEnd Node to Network Node Server 
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Visual 8-22. SNA Local Node Characteristics 


When you configure your control point (local node name), you automatically get an 
LU with the same name. It is called the CP LU. You can use this LU for most of 
your communications and never create another local LU. 


Your Network ID identifies the network you are on. You can be on a different 
network than your partner. 


The node with the higher Local node ID will be the primary link station in a negoti- 
able link station situation. 


For a LEN node connection, choose End Node - No Network Node Server. 


Don’t forget to start the Attach Manager if you will be servicing incoming allocates 
on your system. 
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SNA Connections 


H+ To Network Node : 


H+ Bee 


To Primary Host 
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Visual 8-23. SNA Connections 


e LEN connections are connections to a Peer node. 


¢ The + sign means that there is additional information available. The list will 
expand to expose the links that already exist. 


¢ To see the peer connections that already exist, you would just click on the plus 
sign. 
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Visual 8-24. SNA Peer Connections 


SNA Peer Connections 


APCCFGC3 


pe: 
IBMTRNET 
X25DLC 


TWINAX 
SDLC 
SDLC 





e Identify the DLC that you will be using to connect to this particular peer. 


e You can choose an unconfigured DLC, but you will need to configure it later. 


¢ Click on continue when ready. 
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SNA Peer Connections 


N destination address: 3400012345678 
Connection to a peer node 
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Visual 8-25. SNA Peer Connections 


¢ This is the description of the peer node. 


e The link name will default to the next available link. There really is no need to 
change it. 


e The Partner Node Name is the control point name of the remote node. 
e You need to know the name of the remote node’s network. 


e When yo. have finished defining the node, choose Define Partner LUs to define 
the LUs associated with this node. 
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Peer Connection Partner LUs 
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Visual 8-26. Peer Connection Partner LUs 


* An alias is just another name for the partner LU. It is often easier to remember an 
alias than the true fully qualified partner LU name. 


Aliases are case sensitive. If a transaction program tries to use an alias of 
PARTNER, it will not work because | have defined it as Partner. 


A program can be written to use either an alias or the fully qualified partner LU 
name. If you use the actual name, it is not necessary to create partner LU defi- 
nitions. 

e Most programs are currently written to use an alias however, and PLU definitions 
are required. 


e Note that the network ID from the previous panel is appended to the LU name 
when it is added to the list. 


¢ Be sure to click on Add to get the values added to the list. 
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Transaction Program Definitions 


\APPC\APPCSRV.EXE 


Program parameter string: Hello This is the SEAVER Optional 


Transaction Program Definition Optional 
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Visual 8-27. Transaction Program Definitions 


A Transaction Program definition is only necessary if other systems will be issuing 
allocates to your system. This will match up an incoming transaction program 
name with the correct executable file. 


The Attach Manager is what actually uses this profile. 


e A service TP is one that is written by IBM using the Basic conversation verbs. 
They typically perform a special service such as Remote Data Services for 
accessing the Extended Services for OS/2 Database Manager. 


The TP name is case sensitive and must match the name that will be coming 
across on the Allocate. 
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Additional TP Parameters 


ueued, operator started 


ull screen ueued, operator preloaded 
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Visual 8-28. Additional TP Parameters 


The operation types mean: 


Queued, Attach Manager started: Each incoming Allocate will be queued and only one 
instance of this transaction program will run at a time. As soon as one 
remote TP is through with it, the next Allocate in the queue will be serviced. 


Queued, Operator started: This is the same as above except an operator must be 
present to start the program as the Attach Manager will not start it. 


Queued, operator preloaded: If the program is not already running, incoming Allo- 
cates will be rejected. 

Non-queued, Attach Manager started: Starts a new instance of the program for each 
incoming Allocate. This will minimize the wait at the other end, but it will put 
more stress on this system. 
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Local LUs 


Another local LU 





APCCFQ08 


Visual 8-29. Local LUs 


e Because you already have a local LU by default, it is seldom necessary to create 
additional local LUs. 


e One reason you may need to create an additional local LU is when a transaction 
program is coded to use a specific LU alias. 


e¢ Transaction programs always refer to local LUs by their alias. This allows a trans- 
action program to be developed independent from the underlying network. 
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Minimum contention winners: = 


Mode Definition 
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Visual 8-30. Modes 


e Because there are several modes provided by Communications Manager, it is 
seldom necessary to create additional modes. 


e One reason you may need to create an additional mode is when a transaction 
program is coded to use a specific mode name. 


¢ Class of Service is also provided and has the same names as the provided modes. 
(except for #CONNECT) 


e You must specify how many sessions, with a particular partner, will be able to use 
this mode. 

¢ Minimum contention winners is used to specify the number of sessions you wish to 
be the contention winner of. A contention winner is the Primary LU and will have 
first speaker status. 

e RU Size - The default RU size will use 256 bytes as the minimum RU size. The 
maximum RU size will be set to the maximum RU that can be sent on the link 
without segmentation. When you choose maximum RU size, you can set the 
maximum RU size rather that defaulting. 


e All values in a mode can be negotiated between the partners. 
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Unit 9. Advanced Peer to Peer Networking (APPN) 


What This Unit is About 


In this unit, we will take a look at Advanced Peer to Peer Net- 
working (APPN). APPN is an extension to the SNA Low Entry Net- 
working architecture. The primary advantages to APPN are 
reduced cost, dynamic configuration, and SAA support. Through 
the use of APPN, you will be able to drastically reduce the amount 
of configuration that must be done to your network. 


What You Should Be Able to Do 


After completing this unit, you should be able to 
¢ Configure an APPN Network Node. 
¢ Configure an APPN End Node. 
e List the functions and benefits of APPN. 
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Topic 9.1. Advanced Peer to Peer Networking 


9-2 Communications Manager 
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Connecting Type 2.1 Nodes 
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Visual 9-1. Connecting T2.1 Nodes 





How can you connect these systems 
So that they can all talk to each other? 
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The Problem With LEN Nodes 





APNOVRO2 


Visual 9-2. The problem with LEN Nodes 


¢ One of the major problems with LEN nodes is that they only allow two adjacent 
T2.1 nodes to communicate. This means that each node will need to have a link 
(connection) to every other node it will communicate with. 


¢ This also requires a lot of advance configuration, as each node that you will com- 
municate with must be pre-configured. 


e As the number of nodes grows, the amount of configuration grows exponentially. 


¢ Cost is also an issue. It can get very expensive to maintain a link to every other 
node you wish to communicate with. 


SN en a as 
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The Solution: APPN 


ua 


SS, Network Node 
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Visual 9-3. The Solution: APPN 


APPN is an extension to the type 2.1 node. It does not replace the SNA Low Entry 
Networking. In fact, a LEN node can still participate in an APPN network. APPN 
addresses the concerns raised on the previous page by: 
¢ Providing the capability to route communications to another node through an inter- 
mediate (Network) node. This way, the only links that need to exist are links to the 
intermediate node. 


e Allowing the network to dynamically configure, locate resources, and choose 
routing. 


¢ As part of SAA it also allows customers to retain their investment dollars in a tech- 
nology that won’t be abandoned tomorrow. 


e APPC and LU 6.2 remain unchanged. APPC programs run in an APPN network 
just like they did between LEN nodes. 
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Complex APPN Network 
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Visual 9-4. A Complex APPN Network 





EN 
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¢ APPN provides for decentralized peer networking. No longer do you need to have 


a master (host) present to provide for networking. 


e There are many different ways to set up an APPN network. It is very arbitrary and 
it can be set up in the way that best accomplishes the work to be done. 


e APPN is very easy to set up and use. Since most of the network configuration is 


dynamically created, the setup work is minimized. 


e Network nodes can act as intermediate nodes in connections between other nodes 


in this network. 


network. 


as intermediate nodes. 


9-6 Communications Manager 


The network nodes will also choose the best route for the session through the 


Network nodes can themselves participate as origin and destination nodes as well 
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APPN Node Types 


m End Node (EN) 
mw Network Node (NN) 


gw Low Entry Networking Node (LEN) 
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Visual 9-5. APPN Node Types 


Each of these node types will be discussed further in the following pages. 
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End Node 


w A node that implements some of the APPN extensions 
to the T2.1 architecture. 


g@ May participate in an APPN network by using the services 
of an attached adjacent network node server. 


mw Provides no network services to other nodes. 
m Provides session services for its own LUs only. 


g May have a pair of CP - CP sessions with its network 
node server. Without these sessions, it is treated 
as a base T2.1 node (LEN) by the server. 


g Can register its LUs with its network node server. 
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Visual 9-6. End Nodes 


e An end node cannot act as an intermediate node in a network. It can only be an 


origin or destination node. 


e The CP - CP sessions are used for communications between the end node and the 


9-8 


network node. It is across these sessions that the dynamic network configuration 
occurs. 


One part of the dynamic configuration occurs when an end node registers its LUs 
with a network node. This makes the location of that end node’s LUs known to the 
network. This occurs automatically when the end node comes online (establishes 
a connection) to the network node. 


Some IBM products that can act as end nodes include: 

— Extended Services for OS/2 Communications Manager 

— AS/400 

— DPPX/370 

— OS/2 Extended Edition 1.3 with Networking Services/2 installed. 
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Network Node 


gw Anode that implements all of the APPN extensions 
to the T2.1 architecture and provides: 


- Connectivity Functions 

- Distributed Directory Functions 
- Intermediate Session Routing 

- Route Selection Functions 

- Data Transport Functions 

- Network Management Functions 


mg These functions are provided for: 
- The network node itself 
- APPN End nodes it is serving 
- LEN Nodes that it is serving 
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Visual 9-7. Network Nodes 


e A network node provides all of the APPN functions, including Intermediate Routing 
Services, Topology Routing Services, and Directory Services. 


e A network node can provide these services to its adjacent end nodes and LEN 
nodes. When it does, it is known as a Network Node Server. 


e When a network node is serving a LEN node, the LEN node must be pre defined in 
the network node. It cannot register with the network node. 


¢ Some IBM products that can act as network nodes include: 
— Extended Services for OS/2 Communications Manager 
— AS/400 
— S/36 with the APPN feature 
— OS$/2 Extended Edition 1.3 with Networking Services/2 installed. 
— 3174 with LIC C1.0 
~— TAM - Cul rene re\ene 05 a 
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LEN Node 


@ A node that implements the base T2.1 architecture 
and none of the APPN extensions. 


wg May participate in an APPN network by using the 
services on an attached network node server. 


g Cannot establish CP-CP sessions. 
g Provides no network services to other nodes. 
mg Provides session services for its own LUs only. 


g Cannot register its LUs to its network node server. 
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Visual 9-8. LEN Nodes 


¢ Since a LEN node cannot have CP - CP sessions, it is not able to register with its 
network node server. Therefore, the LEN node must be pre-defined to the network 
node server. 


e A host subarea network that is attached to a network node is considered to be one 
large LEN node. This means that every node in the subarea that you wish to com- 
municate with must be pre-defined. More on this later. 


e Any product that supports the base T2.1 node may act as a LEN node in an APPN 
network. 
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APPN Functional Overview 


gw Directory Services 
mw Topology Routing Services 


wg Intermediate Routing Services 
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Visual 9-9. APPN Functional Overview 


While these are not all of the services provided by APPN, they are the most important 
for this overview. We will explore each of these services in the following foils. 
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Directory Services 


A directory is a table of resource names (LUs) and their 
respective owning control points. 


mw Local Resource Directory (EN) 
- Each node contains a list of its own LUs and 
LUs in adjacent (Peer) nodes. 


- These must be explicitly defined. 


mw Network Node Directories 
- Domain Directory 


- Cache Directory 
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Visual 9-10. Directory Services 


e Directory services is responsible for determining which node a resource resides 
in. 

All T2.1 nodes have a directory to locate LUs in the neighboring nodes. This is the 
Local Resource Directory. 


Local Directory entries are statically defined by system definition. 


e A network node has the capability to provide directory services for other nodes. 


e A resource in a directory is usually a control point or LU, but they can also be 
files, devices, or any other implementation defined resource. 


e All resource names must be unique within a network. 


e When an attempt is made to communicate with another LU, the directories are 
searched to find the location of that LU in the network. 
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Domain Directory 


mw Contains entries for resources within the 
network node itself. 


mw Contains entries for resources located in the 
end nodes that it serves. 


mw These resources are known as the network node's 
Domain. 
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Visual 9-11. Domain Directory 


¢ The domain directory is where all LUs that belong to a given network node’s 
domain are kept. 


e When an end node registers its LUs with the network node, the entries go in the 
domain directory. 


e Explicitly defined LEN nodes locations are also kept in the domain directory. 
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Cache Directory 


w Contains resources located in other domains. 


@ Both the origin and destination network node 
server cache the results of the most recent 
successful directory searches. 


@ Entries in the cache directory are an “educated 
guess" of a resource location. 


gw Cache hits are verified by directing a search to 
the destination network node. 


@ When the cache directory is full, an aging algorithm 
is used to replace the least recently used entry. 
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Visual 9-12. Cache Directory 


¢ The cache directory is used to store the location of a resource that is not in the 
network node’s domain. 

e¢ An entry is made in the cache directory when a network node sends out a locate 
request for a LU that it does not know about. 

¢ When the location of the LU is returned, it is entered into the cache directory so 
that any future requests for that LU will be known and will not need to have a 
locate request sent out. 


a he 
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Creating Entries in a Directory 


a Explicit System Definition 
Used for LEN nodes, APPN end nodes without 
CP - CP sessions to a server network node, and 
for subarea connected resources. 


m Registration 
An APPN end node with CP - CP sessions dynamically 
registers its local resources with its server 
network node. 


g Caching 
When a search originates from an end node, 
the network node created an entry for both the 
origin and destination resources. 


APNOVRI3 


Visual 9-13. Creating Entries in a Directory 


e When a destination LU’s location is not known by the origin LU’s network node 
server, a locate request is sent out to each of its adjacent network nodes. Each 
one of these network nodes then sends the locate to each of its adjacent network 
nodes until every network node has received the locate request. 


e Even if the destination LU is located at a particular network node, the locate 
request is still propagated. This is done to make sure that there are no duplicate 
names in the network. 


Eventually, a reply to the notification will be returned. If the LU was found, its 
location (Network node, End node, LU name) is entered into the cache directory. 


¢ When an LU is found in the cache directory, a search is still sent out to see if the 
resource is still there, but it is sent directly to the owning network node in a search 
called a “Directed Search”. It is not propagated to every network node. 
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Topology Routing Services 


w Topology routing services calculates the least 
weight route between an origin and a destination 
node. 


gu Route selection is based upon: 
¢ Topology Database Information 


« The Class of Service characteristics requested 
by the session. 
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Visual 9-14. Topology Routing Services 


¢ Topology routing services determines the path that will be taken from the origin LU 
to the destination LU. It includes the particular links as well as the nodes that will 
be traversed in route to the destination. 


¢ Every network node in the network knows about all other network nodes and all of 
the links that connect them. This is the topology database. 


e The least weight route is the best route that meets the requirements set forth in the 
class of services that was selected for the session. 
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Topology Database 


mg The topology database contains current network node 
and link status. 


@ Each network node has a copy of the complete 
topology database. 


ug The topology database is dynamically updated in 
response to route and node status changes. 


mg Changes in link and node status are communicated 
by propagating Topology Database Updates (TDUs) 
from the originating node to the adjacent nodes across 
the CP - CP sessions. 


@ The nodes receiving the TDUs continue to propagate 
them to their adjacent nodes until all NN topology 
databases reflect the updates. 
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Visual 9-15. Topology Database 


e Whenever there is a change to the network topology, a topology database update 
is transmitted on the CP - CP sessions that connect the network nodes. 


¢ There is only one topology per network. Each network node has a copy of this 
topology. It includes: 


— All network nodes and their properties. 
— All transmission groups (links) between the network nodes and their properties. 
¢ The topology contains no information about end nodes or LEN nodes. 


e When a new network node come into the network, the entire topology is updated 
and transmitted to the network nodes. 


e Any changes that occur in the network cause a broadcast of only those changes 
rather than the entire topology. 


© Copyright IBM Corp. 1992 Unit 9. Advanced Peer to Peer Networking (APPN) 9-17 


Student Notebook 


Class of Service 


@ A user (LU) can request that a session use particular 
nodes and links based on a class of service entry. 
mw Some values used in class of services are: 
« Speed 
¢ Security 
@ Cost 
= During session initiation, the Topology Routing 
Services compares the available paths and nodes. 


The best route available which meets the COS 
requirements will be selected. 
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Visual 9-16. Class of Service 


Nodes and Transmission groups have properties associated with them. 


Based on the class of services chosen for the session, these properties are 
mapped to node and TG weights. 


The node weight is a relative measure of the goodness of that node or TG for that 
class of service. 


The route that is chosen will be the one with the least weight. 


The class of service indicates the relative importance of each node and TG prop- 
erty. 


There are five pre-defined COS definitions: 
— Default class 

— Batch oriented 

— Interactive oriented 

— Batch oriented with security 


— Interactive oriented with security 
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Intermediate Session Routing 


gw The APPN intermediate routing is acomplished entirely 
by machine microcode and requires no user-maintained 
application or routing tables. 


a When the optimum route has been selected, the Topology 
Routing Service builds a Route Selection Control Vector 


(RSCV). 


g The RSCV carries routing information describing the 
total network path from origin to destination. 


mg The RSCV is an ordered list of each node (CP) and link 
(Transmission Group) traversed in the session path. 


@ As the BIND flows from the origin CP to the destination 
CP, it creates "Session Connectors" in each network node. 
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Visual 9-17. Intermediate Session Routing 


¢ The maximum length of the RSCV is 255 bytes, so the maximum number of inter- 
mediate nodes varies with the length of the CP names. 


e A session connecter is represented by a pair of LFSIDs. 
— One LFSID represents the session address on the incoming link. 
— The other LFSID represents the session address on the outgoing link. 


e A session connector designates a unique route for a session through a network 
node. 


e The chain of session connectors provides a “next adjacent” eu linkage from 
origin to destination. 


LFSID Logical Form Session Identifier. 
RSCV Route Selection Control Vector 
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APPN 
StoryBoard 


Demo 
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Visual 9-18. APPN Storyboard Demo 


¢ This Storyboard demo is available to you. There is a file called APPNDEMO.ZIP in 
the C:\S7049 directory of each system. You may make a copy of this, and anything 
else in that directory for that matter. 


e The file will need to be unzipped with the PKUNZIP2.EXE program. This program 
comes with OS/2 Extended Services 
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Topic 9.2. APPN Configuration 
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Unit 9. Advanced Peer to Peer Networking (APPN) 
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Network Node Configuration 
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Visual 9-19. Local Node Configuration 


¢ The example above shows the Local node configuration for a network node. 
e For an end node, you would select End node to Network Node Server 


— If your network node server is on a LAN, you can place the LAN address of the 
network node in the correct field. 


— This will actually create your connection to the network node, and you do not 
need to explicitly create such a connection. 
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End Node Connections 
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Visual 9-20. End Node Connections 


e A network node should create connections to each of the end nodes that it serves. 


e Note that you no longer define partner LUs here because they are no longer asso- 
ciated with a particular link. 
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Network Node Connections 


Connection to a network node 
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Visual 9-21. Network Node Connections 


e This is used to connect network nodes to other network nodes and to connect end 
nodes to network node servers. 


e An end node will automatically get one of these when configured as an end node 
to a network node server. 


e Network nodes should create one of these connections for the other network nodes 
it will connect to. 


Note: A network node may not want a connection to every other network node. 


a a a 
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Partner LU Definitions 


partner LU definition. 
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Visual 9-22. Partner LU Definitions 


¢ The only real distinction for these partner LUs is that they are no longer associated 
with a particular connection. 


¢ The network node will determine the best route to the partner LU. 
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Unit 10. Advanced APPN Topics 


What This Unit is About 


This unit will cover some of the more advanced topics of Commu- 
nications Manager APPN. These topics are not advanced in their 
complexity. In fact, they serve to make APPN configuration even 
easier. The reason they are labelled advanced is that most of 
them cannot be configured with the PM panels. You must use an 
editor and modify a special text file. Others are optional features 
that may not even be used on a regular basis. 


What You Should Be Able to Do 


After completing this unit, you should be able to 
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Use Link level, Session level, and Conversation level security. 
Edit an APPN NDF file. 
Configure a connection network. 


Configure the system to use implicit modes and inbound 
partner LUs. 


Define a wildcard entry in the APPN directory. 

Configure transaction program defaults. 

Understand the purpose of adaptive pacing. 

Understand the purpose of RU segmentation and reassembly. 
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Security 


w Link Level 
mw Session Level 


w Conversation Level 
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Visual 10-1. Security 


¢ The security features provided have nothing to do with protecting or encrypting the 
data exchanged by the programs. That is left to the programs themselves. 


e Each of these security features is completely independent of the others. You can 
use one, none, or any combination. 


e All security information is stored in a binary file with the extension .SEC. This file 
is located in the C:\CMLIB\APPN directory. 
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Link Level Security 


w Link level security relates to the physical 
security of the logical link. 


w Link security is very important for route 
calculation. 


w If the security for a link does not fall within 
the COS for the session, the link will be 
considered unacceptable. 


w Communications Manager assigns a security 
value to each DLC. 


mw You can override the assigned security for a 
DLC and assign your own. 
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Visual 10-2. Link Level Security 


e Link security can be changed by editing the NDF file and changing the security 
parameter for a link definition. 


¢ When a COS is used that requires higher security than the link offers, that link will 
not be available for routing decisions. 


e Usually, you do not need to change the default security for a link. 


e There are seven defined security values: 


nonsecure 
public_switched_network 


underground_cable 


secure_conduit 


guarded_conduit 


encrypted 


guarded_radiation 
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There is no security on the link. 
Specifies transmission over a public switched network. 


Specifies transmission over a secure underground 
cable. 


Specifies unguarded conduit, such as pressurized pipe. 


Specifies guarded conduit protected against physical 
tapping. 
Specifies that link-level encryption is provided. 


Specifies guarded conduit protected against physical 
and radiation tapping. 
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Session Level Security 


w Used to determine whether two LUs are allowed 
to establish a session with each other. 


mw Used to prevent unauthorized computers from 
establishing a session to your computer. 


mw The session security password is used as an 
encryption key. The LU issuing the BIND will 
encrypt the BIND data before sending it. 


w The other system must have the same key in order 
to decrypt the data and have it recognized as a 
BIND. 


mw A session security password is never sent 
over the link. Both systems must have the 
password configured. 
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Visual 10-3. Session Level Security 


¢ Session security cannot be used with implicit inbound partners. 
e Passwords can be either HEX format or character format. 
— HEX passwords must be 16 characters long. 


— Character passwords must be 8 characters long. 
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Conversation Level Security 


mg Used to validate the identity of the initial sender. 


@ Used to prevent unauthorized users from accessing 
your workstation and its resources. 


mu Unlike session security, the USERID and PASSWORD 
are sent across the session to be validated at the 
other side. 


uw Conversation security is optional and you decide 
whether or not to require it for a program. 


@ You can require conversation security for some 
programs and not require it for others. 
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Visual 10-4. Conversation Level Security 


e If a user sends a USERID and a PASSWORD, it will be checked at the receiving 
system, regardless of whether the receiving TP requires security. 


e If the password is not in the table of valid users on the receiving system, the user 
will not be able to run any TPs on the system. 


e USERIDs and PASSWORDs are CaSe SeNsItIvE. 


e USERIDs and PASSWORDs are stored in a table on the system receiving the 
attach. The sending application must somehow get the USERID and PASSWORD 


from the user. 


e There is only one conversation security table. Users in this table can run any 
transaction program on the system. If they are not on the list, they can only run 
TPs that do not require security. 
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Session Security Configuration 


o add a password, select one local LU alias and one partner LU. Provide the requested : 
formation, then save. When you have defined all LU to LU Passwords, select OK 


‘Undefined nam 


USIBMES.ATL 
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Visual 10-5. Session Security Configuration 


e Session security works between a specific pair of LUs. 


e The partner LU does not have to be defined on the outbound side to use session 
security. It must be defined on the inbound side though. 


e Make sure that you click on Save to enter the data into the table, before clicking 
OK or pressing Enter. Otherwise, the data will not be saved. 


e Remember, the password must exactly match at both ends of the desired session 
in order to establish the session. 


CaSe SeNsitlvE 
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Conversation Security Configuration 


From: 0S28064 





Visual 10-6. Conversation Security Configuration 


¢ The first step in using conversation security is to require it for some of your trans- 
action programs. 


e Once the security requirement has been turned on, the user must be in the conver- 
sation security table to use this TP. 
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Conversation Security Configuration 


nter User ID and password twice for confirmation, and then select Save. 
hen you have defined all User IDs and Passwords, select OK 


Defined user IDs 


etype the 


password: 
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Visual 10-7. Conversation Security Configuration 


e This is where USERIDs and PASSWORDs are added to the table. 


¢ Make sure that you click on Save to enter the data into the table, before clicking 
OK or pressing Enter. Otherwise, the data will not be saved. 


e Utilize User Profile Management will cause the Attach Manager to check the UPM 
database if the USERID and PASSWORD was not found in the conversation secu- 
rity table. It will always check the table first. 


¢ The recommended method is to always use UPM for the checking. The table is 
good to overcome a few UPM restrictions though: 


— UPM USERIDs and PASSWORDs can only be eight characters long. 
— A UPM PASSWORD must be at least four characters long. 


— UPM always stores the values as uppercase. 
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Conversation Security Verification 


piConversation security verification 
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Visual 10-8. Conversation Security Verification 


e If you turn on conversation security verification for a particular partner, you can 
then accept either a USERID and PASSWORD, or a USERID and an indicator that 
shows the user as having already been validated. 


¢ This is usually used when one TP starts another TP on behalf of a third TP. 
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Transaction Program Defaults 
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Visual 10-9. Transaction Program Defaults 


¢ The default transaction program works like this: 


— If an attach comes in for a transaction program that does not have an explicit 
definition, the transaction program defaults will be used. 


— The default path will be searched in an effort to find an executable file with the 
same name as the incoming transaction program name. 


— If an executable is found, that program is run using the values set on this panel. 


e The default program directory is the path that will be searched for the executable 
files. If you put an asterisk here, the entire PATH specified in CONFIG.SYS will be 
searched. 


e This is great for reducing system configuration requirements. 


e Only the first eight characters of an incoming TP name will be used for the execut- 
able file name. No long file name support. 
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Network Definitions File 


gw The NDF file is an ASCII text description 
of your SNA network definitions. 


w The file can be edited with any text editor. 


w Some advanced features can only be configured 
by editing the NDF file. They have no PM panel. 


mw Editing the file is also good for making quick 
duplications of items like partner LU definitions. 


w Verification must be performed, after the NDF 
file is changed, before the changes will take 
effect. 
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Visual 10-10. Network Definitions File 


¢ The verification process creates a file with an extension of .CF2. This is the binary 
representation of the NDF file that Communications Manager uses when it oper- 


ates. 

e The CF2 file is located in the C:\CMLIB\APPN directory. 

e When changes are made to your network configuration with the PM panels, those 
changes are written to the NDF file. 


¢ Verification can be performed outside of the Communications Manager configura- 
tion panels by running the verify program from the Communications Manager 


group. 
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Sample NDF file 





DEFINE LOCAL_CP FQ_CP_NAME(USIBMES.0S28864 ) 
CP_ALIAS (0528064 ) 
NAU_ADDRESS ( INDEPENDENT_LU) 
NODE_TYPE(EN) 
NODE_ID(X'FA686') 
HOST_FP_SUPPORT(NO) ; 


DEFINE_LOGICAL_LINK LINK NAME(LINK68@3) 
ADJACENT_NODE_TYPE (NN) 
PREFERRED_NN_SERVER(YES) 

DLC_NAME (IBHTRNET) 

ADAPTER_NUMBER(8) 

DESTINATION _ADDRESS(X'4e0086648668') 
CP_CP_SESSION_SUPPORT(YES) 
ACTIVATE_AT_STARTUP (YES) 
LIMITED_RESOURCE (NO) 


LINK_STATION_ROLE(USE_ADAPTER_DEFINITION) 


SOLICIT_SSCP_SESSION(NO) 


EFFECTIVE _CAPACITY(USE_ADAPTER_DEFINITION) 
COST_PER_CONNECT TIME(USE_ADAPTER_DEFINITION) 


COST_PER_BYTE(USE_AODAPTER_DEFINITION) 
SECURITY(USE_ADAPTER_DEFINITION) 


PROPAGATION _DELAY(USE_ADAPTER_DEFINITION) 


USER_DEFINED_1(USE_ADAPTER_DEFINITION) 
USER_DEFINED 2(USE_ADAPTER_DEFINITION) 
USER_DEFINED 3(USE_ADAPTER_DEFINITION) ; 


DEFINE PARTNER_LU FQ_PARTNER_LU_NAME(USIBMES.OSZ8G64N ) 
PARTNER_LU_ALIAS (0S28664N) 
MAX_MC_LL_SEND_SIZE(32767) 
CONV_SECURITY_VERIFICATION(NO) 
PARALLEL_SESSION_SUPPORT(YES) ; 


DEFINE DEFAULTS IMPLICIT INBOUND _PLU_SUPPORT(YES) 
DEFAULT MODE_NAME (BLANK) 
MAX_MC_LL_SEND_SIZE(32767) 
DIRECTORY FOR_INBOUND_ATTACHES(*) 
DEFAULT_TP_OPERATION(NONQUEUED_AM_ STARTED) 
DEFAULT TP_PROGRAM_TYPE (BACKGROUND) 
DEFAULT TP_CONV_SECURITY_RQD(NO) 
MAX_HELD_ALERTS (16) 


DEFINE TP TP_NAME(APPCSRV) 
FILESPEC(D: \APPCSRV. EXE) 
PARM_STRING(From: 028864) 
CONVERSATION TYPE (EITHER) 
CONV_SECURITY_RQD(NO) 
SYNC_LEVEL (EITHER) 
TP_OPERATION(NONQUEUED_AM STARTED) 
PROGRAM TYPE(VIO_WINDOWABLE) 
RECEIVE_ALLOCATE_TIMEOUT( INFINITE) ; 


START_ATTACH_MANAGER; 













Visual 10-11. Sample NDF file 





¢ Most of the entries in this example relate directly to changes that you have made 
with the PM panels in lab. 


¢ Some of the values, that you may not recognize, will be discussed in the following 


foils. 
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Connection Network 





Visual 10-12. Connection Network 


e A connection network allows systems on a LAN to establish a direct link with each 
other without explicitly defining that link. 


e All of the systems in a connection network must have a configured link to a 
network node server. 


e When an end node wants to talk to another end node, it will send the locate 
request to the network node like always. 


e When the network node discovers the location, it sends back an RSCV that 
describes a direct path to the end node. 


e The end nodes can then establish a direct link to each other without using the 
network node as an intermediate node. 


e LEN node cannot participate in a connection network. 





© Copyright IBM Corp. 1992 Unit 10. Advanced APPN Topics 10-13 


Student Notebook 


Connection Network Configuration 


g@ DEFINE_CONNECTION_NETWORK 
FQ _CN_NAME (APPN.IBMCONN) 
ADAPTER_INFO (DLC_NAME (IBMTRNET) 

ADAPTER_NUMBER (0)) ; 


g Put this statement in the NDF file of all systems 
that will be part of the connection network. 


ADVCNTC2 


Visual 10-13. Connection Network 


¢ The connection network name can be anything you like as long as it is a unique 
name. 


¢ Each system in the connection network must use the same name. 


¢ Up to five adapters can be described. 
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Implicit Definitions 


gw Implicit Partner LU 


« Network definitions can be configured to accept 
inbound requests and build the partner LU 
dynamically. 


« The fully qualified partner LU, rather than an 
alias, can be specified on outbound requests. 


gw Implicit Links 
« When a connection attempt is originated by an 


undefined adjacent node, an implicit link will be 
created. Implicit links are preceded by an @ sign. 


a Implicit Modes 


¢ If a default mode has been specified in configuration, 
any mode name can be used on inbound or outbound 
requests. If the name is not recognized, the default 
mode will be used. 


ADVIMPO' 


Visual 10-14. Implicit Definitions 


¢ Unfortunately, most programs are currently written to use an alias to specify the 
partner LU. Therefore, it is still often necessary to create a partner LU profile, 
even though you technically do not have to. 

e If you are only receiving attaches, you can use the implicit inbound PLU support to 

avoid creating any partner LU definitions. 

You should always explicitly define the links between END/LEN nodes and network 

node servers. 


An implicit mode is actually created with the name that was specified. The con- 
tents of this new mode will be the same as the default mode. 


While it is not mentioned in this foil, implicit CNOS is also available. By using 
implicit CNOS, you do not need to predefine the session limits. You can use 
explicit CNOS to another PLU if you need to. 


CNOS Change Number Of Sessions 
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Wildcards 


w Used to reduce the burden of defining all LEN node LUs 
to a network node server. 


mw Two types: 
¢ Partial Wildcard 
USER1* 
USER2* 


@ Full Wildcard 
* 


= Especially useful for a network node that is attached to 
a subarea network. 


gw By assigning all unrecognized LUs as belonging to the 
subarea LEN node, you can avoid explicitly defining 
all of the subarea LUs. 
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Visual 10-15. Wildcards 


¢ Only one network node in an APPN network can use a full wildcard. 


¢ Be careful in choosing your wildcards. If one network node uses a wildcard of 
USER* and another uses USE”, both will return a positive reply to a search request 


for USER123_ 
e Make the prefixes unique and do not overlap them. 
e A wildcard will only be used if there is not an explicit entry located. 
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Session Flow Control 


mu Adaptive Pacing 
@ Session Level Pacing 
« BIND Pacing 


@ The pacing window can be changed dynamically, 
based upon conditions at the receiving node. 


= Segmenting and Reassembly 


« RUs larger than the Basic Transmission Unit 
of a link can still be sent across the link. 


« Large RUs are broken up into several smaller 
segments that can be sent across the link. 


« The segments are then reassembled into an RU 
at the receiving node. 
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Visual 10-16. Session Flow Control 


e If a node is very busy, it can dynamically lower its pacing window size to lighten 
the load. When congestion eases, it can again raise its pacing window. 


¢ Segmentation is key to being able to route over several links which do not have 
the same data handling capabilities. 
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Unit 11. 5250 Work Station Feature 


What This Unit is About 


The 5250 Work Station Feature of Communications Manager pro- 
vides the ability to emulate 5250 terminals and printers from an 
OS/2 work station. The 5250 emulation uses SNA LU 6.2 and 
APPC to communicate with AS/400 and System 36 hosts. 


This unit contains three topics. The first topic gives an overview of 
the features provided. The second topic covers the configuration 
of Communications Manager that is necessary to use the 5250 
Work Station Feature. Finally, the third topic examines the param- 
eters on the AS/400 that must match in order to connect. 


What You Should Be Able to Do 


After completing this unit, you should be able to 
e Describe the 5250 Work Station Feature’s capabilities. 


¢ List the connectivity options that are available to the 5250 Work 
Station Feature. 


¢ Understand the matching host requirements for a connection to 
an AS/400. 


¢ Configure the 5250 Work Station Feature. 
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Topic 11.1. 5250 Work Station Feature Overview 
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5250 Emulation 
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Extended Services/2 
Communications Manager 
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Visual 11-1. 5250 Work Station Feature 
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5250 Workstation Feature 





AS/400 





5250 Work Station Feature 


S260 VRC2 


Visual 11-2. 5250 Work Station Feature 


¢ Terminals 
— IBM 5292 Model 1 (color) 
— IBM 3197 Model C20 (Color) 
— IBM 5291 (Monochrome) 
— IBM 3196 (Monochrome) 
¢ Printers 
— IBM 5224 
— IBM 5256 
— IBM 5219 


Note: Printer function tables for IBM Proprinters, Graphics printers, 
Quietwriter printers, and Wheelprinters come with Communications Manager. 
Additional PFTs can be built to support additional printers. Use PC Support or 
Display Write to create PFTs. 
¢ AS/400 requirements 
— OS/400 SSP R 1.2 or higher. 
— AS/400 PC Support is required for file transfer or virtual print functions. 
¢ System 36 requirements 
— $/36 SSP 5.1 or equivalent 
— LAN Communications 
— Base Communications 
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5250 Work Station Feature Connectivity 


5250 Work Station Feature 


LAN 





. 





~ 





Visual 11-3. 5250 Connectivity 


e Twinax can only be used to an AS/400 because the S/36 does not support LU 6.2 
over Twinax. 

e 5250 Work Station Feature cannot be routed through the Communications Manager 
SNA Gateway because the gateway does not support independent LU 6.2. 


e A Work Station that is configured as an APPN Network node can be used to route 
5250 Workstation Feature data to the host. 
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5250 Work Station Feature 


gw Five Terminals/Printers 

gw Individual Keyboard Remap 

m Five Separate Host Systems 

gw Printer Operator Control Panel 

m EHLLAPI API Support 

w Auto Sign On Feature for Terminals 
w Windowed or Full Screen Operation 


gw Host Directed and Local Copy Print Functions 


S2SOVROS 


Visual 11-4. 5250 Features 


Unlike 3270 emulation, the 5250 Work Station Feature can have each session be 
connected to a different host system. 


The auto sign on feature must also be enabled on the AS/400. 


Although the 5250 sessions default to operating in a window, they can be changed 
to run as full screen sessions. 


With AS/400 PC Support, you also get: 

— PC Organizer and Text Assist for full function edit support. 
— Shared Folders 

— File Transfer 

— Messaging between work stations. 


— Virtual print function. 


a 


a 


wa 


a 


Student Notebook 





5250 Work Station Feature 





Visual 11-5. 5250 Work Station Feature in a Window 


e Although the 5250 Work Station Feature runs in a window, all of the sessions are in 
the same window. 


e Use Alt+ Page up to scroll between sessions. 


e There are keyboard remap functions to allow a key to cause a jump to a particular 
session. 


e Can be run in a full screen session as well. 


e There are various font sizes when run in a window. The default font size will be 
the font you have chosen for your OS/2 windowed command prompts. 


e Cut and Paste to/from the PM clipboard is available when run in a window. 
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5250 UPM Logon Panel 
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Visual 11-6. 5250 UPM Logon Panel 


e 5250 Work Station Feature uses APPC conversation security. 


¢ A UPM panel is used for the user to provide the USERID and PASSWORD. These 
are checked at the host system. 


e The userid and password are the users actual host sign on information. 


e The conversation security logon does not actually log the user on to the host 
unless auto sign on is being used as well. 


e Each host that is contacted will cause a UPM logon panel to appear. 


¢ You can use a UPM User Logon Profile to automate the procedure. It will automat- 
ically enter information for remote node logons. 


Nea! 


Topic 11.2. 5250 Work Station Feature Configuration 
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Configure Connections 


onfiguration Choices 
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Visual 11-7. Network Configuration for 5250 


e In order to use the 5250 Work Station Feature, you need to complete the following 
SNA network information. 


— SNA Local Node Characteristics 


— Connections 
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End Node to Network Node Server 


reated by the migration utility on 08- 


Activate Attach Manager at start up 





S258NACS 


Visual 11-8. Local Node Characteristics 


e Your network ID will need to match a value that is configured on the host system. 
For an AS/400, this value can be obtained by looking at the controller description 
for the controller that is defined for your work station. You can issue the command 
DSPCTLD ctl, where ct! is your controller description name. The value that it 
should match is called Remote network identifier. . 


e Your local node name also needs to match a value on your host system. It is also 
contained in the controller description. The value it must match is called Remote 


control point. 
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Configure Links 


| + To Network Node 

Link Name: Adapter: Comment: 
LINKOOO1 IBMTRNET 00 = St. Louis link 
LINKOOO2 IBMTRNET 00 Virginia link 


To Primary Host 
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Visual 11-9. Creating Links for 5250 


¢ The AS/400 or System 36 can be your network node, another end node attached to 
a network node, or a peer node. It all depends on your setup. 


e If you are unsure, and you have a direct connection to the host (ie. LAN), use a 
Peer node link. 


Fa) 


Visual 11-10. Choosing a DLC 


e Choose the appropriate DLC. 


PF Ommcee 
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Select The Appropriate DLC 


imke IAA AL AKA 


X25DLC 


TWINAX 
SDLC 
SDLC 
IBMTRNET 
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Complete Peer Information 


(Required for partne 
U definition) 
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Visual 11-11. Partner Node Information 


Link name: The link name will default. You can change it, but there is no need to. 


Partner network ID: This is the network that the host system is on. On the AS/400, this 
is the Local network ID and can be obtained by using the command DSPNETA. 


Partner node name: This is the host system’s control point name. This can also be 
found with the DSPNETA command, and it should match with the Local control point 
name. 

LAN destination address: This value should match up with the host systems local 
adapter address. On the AS/400, this value is obtained by issuing the command 
DSPLIND line, where line is a valid AS/400 line description. The matching param- 
eter is called Local Adapter Address. 
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Complete Partner LU Information 


o add a Partner LU, enter the LU name, alias, and comment. Then select the 
dd button. 


o change a Partner LU, select an LU from the list. change the LU name, Alias 
nd/or Comment fields and select the Change button. 


o Delete a Partner LU, select an LU from the list and select the Delete button. 





Visual 11-12. Partner LU Information 


¢ The LU name should match up with the host systems local LU. On the AS/400, this 
value can be obtained by issuing the DSPNETA command. The parameter is called 
Default local location 


e¢ The Alias does not need to match anything at the host system. 


¢ The 5250 Work Station Feature requires the use of an alias however. 
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5256 Work Station Feature Configuration 
> 1. Terminal profiles... 

a 2. Printer profiles... 

a 3. Specify APPC LU alias... 


a 4, Session assignments 





Esc=Cancel Fl=Help F3=Exit 
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Visual 11-13. 5250 Work Station Feature Configuration 


e This is the 5250 Work Station Feature configuration main menu. 






Create/Change Terminal Options 


Profile name. . 2... 6 1 5 ee ee ww ew ee tt) AUTOTERM 





For Create, you must select the following item. 
> 1. Common terminal options 


Select the following items only when you want to 
change their values. 


a 2. Color terminal attributes 
= 3. Column separator character... 





Esc=Cancel Fl=Help F3=Exit 


525CFG62 


Visual 11-14. Create/Change Terminal Options 


¢ This is the first panel of the Terminal Options configuration. 


aa an -~ . . a= 












t.emee a 


saan 


cay 


A Panwesinhs IRAE Aone 4NNA 


Common Terminal Options 





Use the spacebar to select. 
Profile name. 2... 1 ee ee ee ee ee ew ee et) AUTOTERM 
COMMONE:. ec cow Boe ek BP ee we RS Be ee Se 
(5258 Work Station Feature Terminal Default Profile J 
AT keyboard profile name... 1... eee ee eee [ACSSAPUS] 
Enhanced keyboard profile name... . 1... 2. ees [ACSSENUS] 
Buffer keystrokes. ©. 6. 1 0 ee ee ee ee ee es > Yes 
a No 
HOSt types <6. ea, WS hae he PSR we Gok ae. g = System/36... 
> AS/468... 





Enter Esc=Cancel Fl=Help F4=List 
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Visual 11-15. Common Terminal Options (part 1) 






Common Terminal Options 


Use the spacebar to select. 









Profile name. 2... ee ee eee ee ee ee eet) AUTOTERM 
GOMMEN Cc se? og koa Soo a Brae aaa ees eal oe | SOE ge a 
[5258 Work Station Feature Terminal Default Profile ] 














Specify Workstation ID Pus] 
NUS] 
Use the spacebar to select. 
Workstation ID (for host). ......... 
Auto-signon,. . 2. 2 2 ee ee ee eee 
/36... 
Enter Esc=Cancel Fl=Help 
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Visual 11-16. Common Terminal Options (part 2) 
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¢ The Workstation ID can be left blank and the host will automatically assign an ID. 
You can specify your own ID as long as it is unique to the host system. 


¢ Auto-signon is only available to an AS/400 and it must be enabled at the host as 


well. 


ftots 44 
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Color Reset Exit 


Color Terminal Attributes (1 of 2) 


Select an item, then press F186 to select color. 


Code and Description 
Green/B8lack 
Black/Green 
White/Black 
Black/White 
Green/8lack Underscore 
Black/Green Underscore 
White/Black Underscore 
Non-Display 

Red/Black 

Black/Red 

Red/Black Blink 
Black/Red Blink 
Red/Black Underscore 
Black/Red Underscore 
Red/Black Blink/Underscore 


eeanepewpeanevwpepwenveewaeavee ¥ 


Esc=Cancel Fl=Help F&Forward 
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Visual 11-17. Color Terminal Attributes (part 1) 





Color Reset Exit Fl=Help 



































Foreground 
a Black a Gray 
s Blue « Light blue 
> Green a Light green 
a Cyan a Light cyan 
a Red a Light red XX 
= Magenta a Light magenta xx 
« Brown = Yellow xx 
a White a Light white Xx 
XX 
Background XX 
> Black a Red XxX 
« Blue s Magenta XX 
« Green « Brown xX 
a Cyan . xx 
XX 
Be en ress Ta ef alata @ Giannis eho" xx 
x 
SNe ee We ete isa SS xx 
xx 





Enter €sc=Cancel eee neal eae 
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Visual 11-18. Color Terminal Attributes (part 2) 


¢ Set the colors to your personal preference. 


e Make sure that you make the foreground and background colors the same on non- 


display fields or the characters will display. 





a4a44a -~ . . es 


f 
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Create/Change Terminal Options 


Profile name... 2... 1. 1 1 6 ee ee ew wt) ~AUTOTERM 


For Create, you must 


Column Separator 


a 1. Common terminal 

Use the spacebar to select. 
Select the following 
change their values. | Column separator character ........... 






« 2. Color terminal a} Display blanks in column 
> 3. Colum separator separator fieldas.......2... 5-20 
> Column separator 
a Blanks 





Enter Esc=Cancel Fl=Help 
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Visual 11-19. Column Separator 


¢ The column separator character will be substituted for any null values in a field 
and, optionally, for any blanks. 


Create/Change Printer Options 
Profile Wate, « sce 8 ew ae we ee we ee Ee PRINTER 
For Create, you must select the following item. 
> 1. Common printer options 


Select the following items only when you want to 
change their values. 


a 2. Printer hardware characteristics 
« 3. Serial or parallel options... 

s 4, Printer initialization string 

a 5. Host printer options... 








Esc=Cancel Fl=Help F3=Exit 
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Visual 11-20. Create/Change Printer Options 


¢ This is the first panel of the Printer Options configuration. 


¢ These panels will only go through the Common printer options. 
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Common Printer Options 













Use the spacebar to select. 


Profile name... 1. 1... 444 «ete w © ee + ¢) PRINTER 
COMMON. ~ 3. ae: 5 5. Gee Seas eit a tg PRS bs Gchs, capa « Ge See 
(5258 Work Station Feature 5256 Printer Default Model Profile] 


AT keyboard profile name... .......... [ACSSAPUS] 
Enhanced keyboard profile name... ....... [ACSSENUS] 
Printer types: cc scc wie SE SO ale OW Ge 


> IBM Proprinter 

a 18M Quietwriter printer 

« IBM Wheelprinter 

« IBM Graphics printer 

a Printer function table... 


UOSE S966 sce ae we ee ww Bee oO a System/36... 
> AS/468... 

Host code page... . 1... ee ee ee eee (637 J 

PC-COde: pages 5:5 oeeecay os ee ce ea ee ww Be (437 J 








Enter Esc=Cancel Fl=Help F4=List 
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Visual 11-21. Common Printer Options (part 1) 


° A printer function table allows you to use a printer that is not listed here. 


Common Printer Options 

Use the spacebar to select. 
Profile name : PRINTER 
Comment 

[5256 Work Station Feature 5256 Printer Default Model Profile] 

Specify Workstation ID 
Workstation ID (for host) 
Enter Esc=Cancel Fl=Help 


a Printer function table... 


Host type a System/36... 
> AS/468... 


Host code page 
PC code page 
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Visual 11-22. Common Printer Options (part 2) 


aa na -~ . ae =. 
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5256 Work Station Feature Configuration 
« 1. Terminal profiles... 
a 2. Printer profiles... 


> 3. Specify APPC LU alias... 


a 4. Session assignments 





Specify APPC LU Alias 






APPC LU alias. 1... 000.4. [0S28864N]} 


Enter Esc=Cancel Fl=Help F4=List 
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Visual 11-23. Specify APPC LU Alias 


e This can be any one of your LU aliases. All 5250 sessions will use the same local 
LU. The easiest way is to use the CP LU, this way you don’t need to create an LU 


explicitly. 
5258 Session Selection 
Session Number Session Type 
Lae ey Terminal 
a2... Not Configured 
e3.. Not Configured 
a 4., Not Configured 
#5. Not Configured 











Esc=Cancel Fl=Help F3=Exit 
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Visual 11-24. 5250 Session Selection 


¢ This is where the sessions are actually defined. 
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5258 Session Selection 
Session Number Session Type 


Terminal 

Not Configured 
Not Configured 
Not Configured 
Not Configured 


5256 Terminal/Printer Session Assignments 


5258 Work Station Feature profile name [TERMINAL] 
APPC partner LU alias [ATLANTA ] 
APPC mode name (#INTER J 
Short session ID 


Enter Esc=Cancel Fil=Help F4=List 
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Visual 11-25. 5250 Terminal/Printer Session Assignments 


5250 Work Station Feature profile name: This is one of the terminal/printer profiles 
that you have created. [F4] will give you a list of profiles. 


APPC partner LU alias: This is the alias for one of your host system partner LUs. You 
can use [F4] for a list of partner LU aliases. 


APPC mode name: This is the name of one of your defined APPC modes. The host 
system will need to have this mode name as well. The easiest method is to use the 
IBM supplied mode #INTER. This way, you don’t need to explicitly create a mode. 
Press [F4] for a list of modes. 


Short session ID: This will default to the next available ID. You may change it, but it 
must be unique among all emulations. 
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Topic 11.3. AS/400 Configuration Parameters 


a ee se 
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Type choices, press Enter. 


Change Ctl Desc (APPC) (CHGCTLAPPC) 





Controller description. .... > OS2RM466 Name 

Ondine at. FPl. 44 6 w uae ® % *YES_ *SAME, *YES, *NO 
APPN-capable. ......... *YES_ *SAME, *YES, *NO 
Switched line list... . 2... TRES1ALN__ Name, *SAME 






















Character code. ........ *EBCDIC *SAME, *EBCDIC, *ASCII 
Maximum frame size... .... 1994 265-16393, 265, 521, 1633... 
Remote network identifier USIBMES_ Name, *SAME, *NETATR, *NONE 
Remote control point. ..... OS2RM466 Name, *SAME, *NONE 

SSCP identifier ........ *SAME 6666G6G86661-FFFFFFFFFFFF.. 
Initial connection. ...... *ANS_ *SAME, *ANS, “DIAL 

Switched disconnect ...... *YES_ *SAME, *YES, *NO 

Disconnect timer... ..... 176 6-65535 seconds 


LAN remote adapter address . . . 488664666666 666666606661-FFFFFFFFFFFF. . 
LAN OSAP eo ca ke ee eH 64 *SAME, 64, 68, OC, 18, 14... 
LAN SEAR gg ae wR we a4 *SAME, 64, 68, 6C, 16, 14... 


More... 
F3=Exit F4=Prompt FS5=Refresh F12=Cancel Fl3"How to use this display 
F24=More keys 


66-37 SA MW KS IM II S1 ATLANTA KB 
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Visual 11-26. AS/400 Controller Description (1 of 3) “DSPCTLD OS2RM400” 


4, NAM 

Xv 4 ~\ Mol 
¢ Remote network identifier = Communications Manager Network ID. 2 aot an 
¢ Remote control point = Communications Manager Local node name. \dk RY 


e LAN remote adapter address = Communications Manager LAN address. “oo 





Change Ctl Desc (APPC) (CHGCTLAPPC) 

















Type choices, press Enter. 

LAN frame retry ........ 16. 6-254, *SAME, *CALC 

LAN connection retry. ..... 16. 8-254, *SAME, *CALC 

LAN response timer. ...... le. 8-254 (6.1 seconds) 

LAN connection timer... ... 78 6-254 (8.1 seconds) 

LAN acknowledgement timer 1 6-254 (6.1 seconds) 

LAN inactivity timer... ... 166 6-255 (8.1 seconds) 

LAN acknowledgement frequency 1 6-127, *SAME, *CALC 

LAN max outstanding frames... 2 1-127, *SAME, *CALC 

LAN access priority ...... 8 6-3, *SAME, *CALC 

LAN window step ........ *NONE_ 1-127, *NONE, *SAME = 
APPN CP session support .... *NO_ *SAME, *YES, *NO Los tee \ Oe 
APPN node type. ........ *ENDNODE *SAME, *CALC, *NETNODE... NolYV WY 
APPN transmission group number 1 1-28, *SAME, *CALC Pat 

APPN minimum switched status . . *VRYONPND *SAME, *VRYONPND, *VRYON 


More... 
F3=Exit F4=Prompt F5=Refresh F12=Cancel F13=How to use this display 
F24=More keys 
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Visual 11-27. AS/400 Controller Description (2 of 3) “"DSPCTLD OS2RM400” 
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Change Ctl Desc (APPC) (CHGCTLAPPC) 
















Type choices, press Enter. 


Recovery limits: 





Count limit 2... 2.04. 2 6-99, *SAME, *SYSVAL 

Time interval ........ 5 8-126 (minutes) 
Model controller description . . *NO_ *SAME, “YES, *NO 
Connection network network ID . *SAME__ Name, “SAME, *NETATR, “NONE 
Connection network CP ..... *SAME Name, *SAME, *NONE 
Control owner . 2... 2 ees *USER *SAME, *USER 
Text ‘description’ ....... ‘Room 488 controller for 0S/2' 








Bottom 
F3=Exit F4=Prompt F5=Refresh F12=Cancel F13=How to use this display 
F24=More keys 
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Visual 11-28. AS/400 Controller Description (3 of 3) “DSPCTLD OS2RM400” 


Change Line Desc (Token-Ring) (CHGLINTRN) 


Type choices, press Enter. 





Line description. ....... > TRE81ALN Name 

Resource name ......... LIN681_ Name, *SAME 

Online at TPL. 6 ek ee ea *YES.. *SAME, *YES, *NO 

Vary on wait. 2... 2 ee eee 15 *NOWAIT, 15-188 (1 second) 
Maximum controllers ...... 256 1-256, *SAME 

Line speed 2.050 6 6 be ews aM 4M, 16M, *~SAME 

Maximum frame size... .... 1994 265-16393, *SAME, 265, 521.. 
TRLAN manager logging level . . *OFF_ *SAME, “OFF, *MIN, “MED, “MAX 
TRLAN manager mode... .... “OBSERVING “SAME, *OBSERVING... 

Log configuration changes ... *LOG_ *SAME, *LOG, *NOLOG 
Token-ring inform of beacon .. *YES_ *SAME, *YES, *NO 

Local adapter address ..... 466667132624 486666006666-7FFFFFFFFFFF... 








More... 
F3=Exit F4=Prompt F5=Refresh F12=Cancel F13=How to use this display 
F24=More keys 
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Visual 11-29. AS/400 Line Description (1 of 3) “DSPLIND &AS4001LINE.” 


¢ Local adapter address = Communications Manager LAN destination address for a 
link. 
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Change Line Desc (Token-Ring) (CHGLINTRN) 

Type choices, press Enter. 
SSAP list: 7 

Source Service Access Point . 04 O2-FE, *SAME, *SYSGEN 

SSAP maximum frame... .. . *MAXFRAME *MAXFRAME, 265-16393 

SSAP TYP 6 6 ee a wl ee *SNA_ *CALC, *NONSNA, “SNA 

Source Service Access Point . 06 62-FE 

SSAP maximum frame... ... *MAXFRAME *HAXFRAME, 265-16393 

SSAP type .......... *NONSNA *CALC, *“NONSNA, “SNA 

Source Service Access Point . AA 62-FE 

SSAP maximum frame. . 2... *MAXFRAME *MAXFRAME, 265-16393 

SSAP type .......... *NONSNA *CALC, *NONSNA, *SNA 

+ for more values _ 

Early token release ...... *SAME *YES, “NO, *SAME, *LINESPEED 
Error threshold level .... . *OFF_ “SAME, “OFF, *MIN, “MED, *MAX 
Link speed. 2... 2... 2 e aM *SAME, “MIN, 1266, 2466... 


More... 
F3=Exit F4=Prompt FS5=Refresh F12=Cancel F13=How to use this display 
F24=More keys 
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Visual 11-30. AS/400 Line Description (2 of 3) “DSPLIND &AS4001LINE.” 





Change Line Desc (Token-Ring) (CHGLINTRN) 




















Type choices, press Enter. 








Cost/connect time ....... 8 6-255, *SAME 
Costfhyte ¢ cee aa we ds 8 6-255, *SAME 
Security for line ....... *NONSECURE *SAME, *“NONSECURE.. 
Propagation delay ....... *LAN *SAME, “MIN, *LAN... 
User-defined1......... 128 6-255, *SAME 
User-defined 2......... 128 6-255, *SAME 
User-defined 3. ........ 128 6-255, *SAME 
Autocreate controller ..... *YES *YES, *NO, *SAME 
Autodelete controller ..... 1446 1-186688 (minutes), “NONE... 
Recovery limits: 

Count limit ........0. 4 6-99, *SAME, *SYSVAL 

Time interval ........ 5 6-128 (minutes) 
Text ‘description’. ...... *BLANK 


Bottom 
F3=Exit F4=Prompt FS=Refresh F12=Cancel F13=How to use this display 
F24=More keys 
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Visual 11-31. AS/400 Line Description (3 of 3) “DSPLIND &AS4001LINE.” 





11-26 Communications Manager 
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os 














Display Network Attributes 





: System: ATLANTA 

Current system name .. 1... 1 ew ee ee : ATLANTA 
Pending system name . 2... 1... eee ee eet 
Local network 10D... 1... 2.2... .... 4. =. : + £USIBMES 
Local control point name... .. 2... ee et ATL 
Default local location. . 2... 1... ee eee 2: ATL 
Default mode... . 2... 2... ee ee ee et) BLANK 
APPN node type... .......44444 4.4. 2 “ENDNODE 
Maximum number of intermediate sessions ....: 268 
Route addition resistance .......-.4.32 128 
Server network [D/control point name... ... : USIBMES STL 
More... 
Press Enter to continue. 
F3=Exit F12=Cancel 
61-61 SA MW KS IM II S1 ATLANTA KB 
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Visual 11-32. AS/400 Network Attributes (1 of 2) “DSPNETA” 








Remote. 


N ode 


+ 
"| 
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oe 
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Local network ID = Communications Manager Partner network ID for a link. 
Local control point name = Communications Manager Partner node name for a 


link. 
Default local location = Communications Manager LU name on a partner LU defi- 


nition. 


Display Network Attributes 


System: 

Alert status «0.624 8 aw ese Ha eS eae CR MORE 
Alert primary focal point .........4.0. :  *NO 
Alert default focal point ..........4. 3: = *NO 
Alert Yogging status . <4 sae we Hae ew ee BAR 
Alert controller description. ......... : SLO61LPU 
Alert-hold count . +54 bee ee Re ee eet OB 
Message queue 2.1 1 ee ee et ee we we ww 2) | QSYSOPR 

RIGPTY gk 8 EG Re we ee Qsys 
OU tpPUt: QUEUE <6 oe. a ee weet stint Se ee, fet, ee QPRINT 

LADRAPY’ on gees ee: BE Bes Rw er ee SB EGS QGPL 
JOB! ACTION oe ce a we We ie we as So OETILE 
Maximum hop count «s4 64 44% ee eee ee 2 426 
ODM request access... .........24.4.4. 3: £*OBJAUT 
PC Support request access . 2... 2 se et ee : *OBJAUT 
Default ISON network type ........... $ 
Default ISON connection list. .........32 QOCCNNLANY 
Press Enter to continue. 
F3=Exit F12=Cancel 
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Visual 11-33. AS/400 Network Attributes (2 of 2) “DSPNETA’” 





ATLANTA 
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Unit 12. Asynchronous Communications 


What This Unit is About 


Asynchronous communications uses an asynchronous modem to 
communicate, over telephone lines, to another asynchronous 
modem on another system. The typical operation that is per- 
formed when doing asynchronous communications is ASCII ter- 
minal emulation. While performing terminal emulation, many other 
tasks can be performed such as file transfer, data capture, and 
screen snapshot. 


Extended Services for OS/2 Communications Manager provides 
the ability to perform asynchronous communications and terminal 
emulation. This is provided through supplied terminal emulators 
and a rich asynchronous communications API. 


This unit will discuss the features of the asynchronous communi- 
cations support in the first topic. The second topic will be devoted 
to configuration of the asynchronous communications features. 


What You Should Be Able to Do 


After completing this unit, you should be able to 


e Describe the features of the Asynchronous Communications 
service. 


¢ Configure the following Asynchronous Communications pro- 
files: 


— Special Function Definitions 

— Device String Profiles 

— Asynchronous Communications Port Profiles 
— Telephone Network Profiles 

— ASCII Terminal Emulation Profiles 

— Asynchronous File Transfer Profiles 


e Use the ASCII terminal emulation feature. 


¢ Perform file transfer through an ASCII terminal. 
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Topic 12.1. Asynchronous Communications Features 
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ASCIl Emulation 
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Extended Services/2 
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Communications Manager 
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Emulation Services 
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Visual 12-1. ASCII Terminal Emulation 
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Asynchronous Communications 





Presentation Manager 
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Visual 12-2. Asynchronous Communications 


¢ Two ASCII terminal emulators, IBM 3101 and DEC VT100, are provided with the 
product. These are PM windowed emulators and support the following PM fea- 
tures: 


— Sizing, minimizing, maximizing, and scrolling of windows 
— Copy data into the clipboard. Only copy is supported. 


¢ File transfer is supported through both of the ASCII emulators. 


— INDSFILE for transfers to/from an IBM host system. 
— Xmodem for everyone else. 


e Users can write their own Asynchronous applications as well through an API 
called ACDI. (for example, SOFTERM) 


e Only one of the provided ASCII emulations can be run at a time. They do not 
support concurrent use. 


¢ COM1 through COMS are supported by Communications Manager 
API Application Programming Interface 


ACDI Asynchronous Communications Device Interface 
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ACDI Redirection 


LANACS V 2.0 


IBM 3101 





Visual 12-3. ACD! Redirection 


ACDI (including the ASCII emulators) can be redirected across a LAN to a system 
with shared modems. The system must be running the LANACS v 2.0 DOS 


program. 


Note: The IBM LAN Server is not a valid destination as a modem server. It must 
be a LANACS server. The LAN server can be used for non-ACDI asynchronous 
communications packages. (for example, SOFTERM in non-ACDI mode): 


This is only good for placing outgoing calls. The server cannot route incoming 
calls to a LAN workstation. 


Redirection uses NETBIOS. 
Can be installed using BCS or REINST (additional features). 


LANACS Local Area Network Asynchronous Connection Server 
NETBIOS Network Basic Input Output System 
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Asynchronous Configuration Profiles 


gw Special Function Definitions 
mw Device String Profiles 
ig Asynchronous Communications Port Profiles 
mw Telephone Network Profiles 
gw ASCII Terminal Emulation Profiles 


mw Asynchronous File Transfer Profiles 
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Visual 12-4. Asynchronous Configuration Profiles 


The following profiles can be configured. Not all are required though: 


Special Function Definitions: This profile will almost never be changed. It sets charac- 
ters to represent a certain function. 


Device String Profiles: This is the way you can customize the commands that are sent 
to the modem. Several profiles are provided for some common modems. 


Asynchronous Communications Port Profiles: Use these to tell Communications 
Manager what type of device is connected to a COM port. 


Telephone Network Profiles: Use these to store any network access numbers that you 
may need to dial before or after a phone number. 


ASCII Terminal Emulation Profiles: These are the actual terminal configurations. A 
phone number is stored with the profile so you want to create one for each party 
you will call. 


Asynchronous File Transfer Profiles: Used to perform file transfers. Menu mode is the 
only mode available for asynchronous file transfers. 


Note: Your modem must be set to reflect the true state of CARRIER and DTR. This is 


done through modem switches or software commands (Hayes: AT &C1 &D2) 
DTR Data Terminal Ready 
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Topic 12.2. Asynchronous Communications Configuration 
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Asynchronous Feature Configuration 


1. Special function definitions... 


> 
a2. 
a 


Specify Special Function Definitions 
Pause character 
Control character 


Escape character 
Carriage return character 


Enter Esc=Cancel Fl=Help 
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Visual 12-5. Special Function Definitions 


You should almost never need to change special function definitions. 











Asynchronous Feature Configuration 
e 1. Special function definitions... 
> 2. Device string profiles... 
« 3. Asynchronous communication 
port profiles... 
a5. Profile Operations 


a 6. P Specify Telephone Network ID 


Telephone network ID 


Enter Esc=Cancel Fl=Help F4=List 








ASCCFG62 






Visual 12-6. Device String Profiles part 1 


The telephone network ID identifies the telephone network you will be using. The 
United States is “011”. Use [F4] to list all of the networks. 


WwW 


if 


Student Notebook 





) 


Create/Change Attention Command Set Strings (1 of 2) 


Use the spacebar to select. 


Device string profile name 
Telephone network ID 
Comment 


Auto answer delay done by 

Device carrier exchange 
timeout (seconds) 

Device initialization 

Dialing prefix 

Olaling suffix 

Auto answer 

Hangup 

Voice to data originate 

Voice to data answer 

Successful command response 

Unsuccessful command response 

Incoming call response 

Valid connection response 


Enter €sc=Cancel Fl=Help F&=Forward 
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Visual 12-7. Device String Profiles part 2 


, Create/Change Attention Command Set Strings (2 of 2) 


Specify call failure types and associated call failure response strings. 
Call failure types: 

1 = Busy indication 

2 = Wrong number 








3 = Other 

Type Response String 

(1) (BUSY|*J J 
[2] [NO CARRIER|*J a 
{] [ ] 
{] if ] 
{] ] 
{] [ ] 
C] [ ] 
C] [ ] 








Enter €sc=Cancel Fl=Help F7=Backward 
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Visual 12-8. Device string profiles 


¢ All of these commands are dependent upon the particular modem you are using. 
Consult the modem documentation for assistance. 


e Use the Hayes models and it will most likely work. 
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Asynchronous Feature Configuration 


Select Asynchronous Communication Port Profile 


Esc=Cancel Fl=Help 





> 3. Create... 
4. Delete... 
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Visual 12-9. Communications Port Profiles part 1 


Asynchronous Feature Configuration 


Select Asynchronous Communication Port Profile 


Specify Telephone Network ID 


Telephone network ID 





Enter Esc=Cancel Fl=Help F4=List 
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Visual 12-10. Communications Port Profiles part 2 











e All three COM ports can be defined and used. Only one can be used at a time 


however. 
¢ Telephone network ID means the same thing here. 


anian ~ . a as. 
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Select Interface Device 














Use the spacebar to select. 





Combs. eS a ee Re Ww ae [ > 
Device Command Set Supported 

> Hayes Smartmodem 1266 & IBM PC Series 2468 Attention (Hayes) 

a Hayes Smartmodem 2468 Attention 

a Hayes V-Series Modem Enhancer 1268 Attention 

a Hayes V-Series Modem Enhancer 2466 Attention 

« IBM PC series 1268 Attention 

a ROLMphone 244PC Attention 

a MicroCom AX/2486C Attention 

a Racal-Vadic V12422S V.25bis 

a User defined... User defined 

u Other modem or device... V.24 (RS232C) circuits 


(no command set support) 


NOTE: Devices requiring character rate pacing during commanding are not 
supported. 





Enter Esc=Cancel Fl=Help 
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Visual 12-11. Communications Port Profiles part 3 


e When you configure a COM port, you are telling the system what kind of device is 
attached to the COM port. 





Create/Change Telephone Network Parameters 










Profile name. 3 2 ee ee ee owe ee cs oe OEM 
COmmentss 5.68 be ee 8 ee ee a 


Telephone network prefix. . 2... 2... ee eae 
{9° > 
Telephone network suffix. ........2..2.24. 


[ 

















Enter Esc=Cancel 





Fl=Help 
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Visual 12-12. Telephone network profiles 


¢ A telephone network profile allows you to specify strings that will be dialed before 
and after the actual phone number (eg. Long distance access codes). 
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Create/Change ASCII Terminal Emulation Profile (1 of 3) 


Use the spacebar to select. 


Emulation mode 

COM port speed 

Bits per character 

Parity type 

Number of stop bits 

Local display 

Auto return 

Enter key CR/LF 
Line-ending control Yes 


Enter Esc=Cancel Fl=Help F4=List F&=Forward 
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Visual 12-13. Terminal Emulation Profiles part 1 





Create/Change ASCII Terminal Emulation Profile (1 of 3) 










IBM 3161 Parameters 













Use the spacebar to select. 
Turnaround character... .......6.0-4 > CR 
a ETX 
EOT 
0c3 
Serovling 6 6 Ki we ee ea Ra ROS > Yes 
a No 
MOde a. is aay i aie: Westin arlene oye Be > Character 
= Block 
Null suppression. . 2... 1 eee eee > Yes 
No 










Enter Esc=Cancel Fl=Help 








Line-ending control... ......-. 
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Visual 12-14. Terminal Emulation Profiles part 2 


e Although there are more parameters here than the other profiles you have seen, 
very few will ever need changing. Several standard settings have emerged over 
time. 





Create/Change ASCII Terminal Emulation Profile (2 of 3) 















Use the spacebar to select. 
Type of connection. ©. 6 6 6 ee eee ee ee ee es 
> Auto-dial... 
a Auto-answer 
Direct 
« Manual dial/leased line 
Automatic flow control. . 2... ee ee ee et ee ee > Yes 
; a No 
Flow control start character. ... 2... ee eee eee [79] 
Flow control stop character... 2... - ee eee eee [*s] 
Minimum time for break 
signal to be sent... 2. ee ee eee ee ee ee ee (358 
Enhanced keyboard profile name... 2... ee ee eee [ACSAENUS ] 
AT keyboard profile name. ©... 2 eee ee ee ee eee [ACSAATUS] 
Transfer files to and from an IBM host through 
a protocol converter... 2... ee ee ee eee eee a Yes... 
> No 





Enter Esc=Cancel Fl=Help F4=List F7=Backward F8=Forward 
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Visual 12-15. Terminal Emulation Profiles part 3 





Create/Change ASCII Terminal Emulation Profile (2 of 3) 
Use the spacebar to select. 


Type of connection. . 2... ee ee ee ee ee 
> Auto-dial... 


a Auto-answer 






Specify String for Auto-Dial 





Telephone network profile name... ........ [DEMO ] 


Telephone number . 2 2 6c ce tte e eevee 
(1-886-555-1212 > 
Call continuation string. . 6 63 es ee ee ew 


[ 




















Enter Esc=Cancel Fl=Help F4=List 
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Visual 12-16. Terminal Emulation Profiles part 4 
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¢ If you are remapping the keyboard, make sure and specify your keyboard profile 


here. 


¢ If you are not using a telephone network profile, leave the field blank. 


¢ The call continuation string can be used to automate logon to the remote system. 
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Create/Change ASCII Terminal Emulation Profile (3 of 3) 


Use the spacebar to select. 


Change parameters for sending 
ASCII text files 


Data capture file name 
Auto-start data capture 
Data snapshot file name 
[ 
Printer page length for 
snapshots (in lines) 
Auto-activate data filter 


Change data filter 


Enter Esc=Cancel Fl=Help F7=Backward 
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Visual 12-17. Terminal Emulation Profiles part 5 


e Data capture is useful for avoiding connect time charges since data can be written 


to disk faster than you can read it online. 


ASCII Terminal Emulation Configuration 
a 1. ASCII terminal emulation profiles... 


» 2. Default ASCII terminal emulation profile... 


Specify Default ASCII Terminal Emulation Profile 


Profile name 


Enter €sc=Cancel Fl=Help F4=List 
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Visual 12-18. Default Terminal 


e A default terminal emulation profile can be specified. This should be the one you 


use most often. It can be overridden at run time if necessary. 
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Create/Change TSO Profile 

Use the spacebar to select. 
Profile name. . . 1 6 2 ee ee ew ew we we wh ew ee et) DEMO 
Comment 666: ois ce ee a ie eke el ee Sit Be 8 SS 

(MODEL PROFILE ASYNC FILE TRANSFER 18M HOST(TSO) TEXT FILES] 
ASCII to/from EBCDIC translation. .........e44.6 > Yes a No 
Use CR/LF as record separator. ......... «oP Yes « No 
PC file code page... .. + ee eae eo re wo ale ce! P4382 
Host file code page. .... 2.2 eee eee wo see. [8387] 
IBM host file transfer command 

NEMS soe es we Te ere teat ae eer os Hs MoS . « (IND$FILE] 
Append to target file ....... By ee a ete ter ar ee a Yes > No 
Modify host file characteristics 

options .... iy aiecceretan, fey teh i ASR ee re ete oS a Yes > No 
One-to-one chaveceer mapping. . 2. 2. 2. «2 eee ee eae > Yes « No 


Enter Esc=Cancel Fil=Help F4=List 


ASCCFG15 


Visual 12-19. File Transfer Profile 





¢ File transfer profiles for IBM hosts look just like the 3270 versions. 


¢ Xmodem is a very unique profile. All it has is a comment line. 


a nh a a 
i 49.46 
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Unit 13. Subsystem Management 


What This Unit is About 


Subsystem management is used to monitor and control communi- 
cations resources. It also allows you to make performance adjust- 
ments in the SNA communications service. During this unit, you 
are going to be presented with the various subsystem manage- 
ment tools that are available to you. 


What You Should Be Able to Do 


After completing this unit, you should be able to 


e List the various subsystem management functions that are 
available. 


e Perform specific subsystem management functions. 


> ——————————— ° 
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Topic 13.1. Subsystem Management 
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Subsystem Management Functions 


gw APPC Transaction Services 

mg Display active SNA configuration 
gw SNA logical link services 

w Session services 

mw Data link control services 

w Attach manager services 

w Signed-on list 

gw X.25 virtual circuit services 

Bw X.25 physical link services 
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Visual 13-1. Subsystem Management Functions 


¢ Subsystem management is under the control of the keylock. When a configuration 
file is locked, no subsystem management functions can be performed, except 


display. 
e In order for Subsystem management to be selectable, APPC must be running. 


a 
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APPC Transaction Services 


> 1. Display active programs 
« 2. Deactivate programs 





Esc=Cancel F1=Help 
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Visual 13-2. APPC Transaction Services 


¢ APPC transaction services allows you to display and deactivate APPC transaction 
programs. 


¢ The display function displays all active TPs. 
e The deactivate function lets you deactivate specific TPs. 
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Display SNA Configuration 


f Logical Unit 6.2 
| Number of logical units (LUs) 


f 1>LU name 

# LU alias 
Fully-qualified LU name 
Default LU 
LU local address wee 
Configured sessions limit 
ippesaenaen programs limit 

ype 

Number of partner LUs (PLUs) 


H1.1>Partner LU alias 

H Partner LU uninterpreted name 
Partner LU name. ak 
Partner LU session limit 

C nane 

Adapter number 
Destination DLC address at° 
Parallel sessions Supported 
Session security | Not configured | 
Conversation security | Configured, Active . 
Already verified security Not configured, Not configured 
Implicit partner ; Ho 
Number of modes for this PLU 


$288664H 
SIBMES .OS28864N 


ependent 


AaetCoo «+ 
ws 


a 
peo man 
w 
UTS 


limit 


n 


864 
: 88080000G0G8" 
MES .0S28864 


8 
5 


Ul ENO 
Wwwme 


ea ancxo =n 
male) 





4 
H 1.1.1>Mode name rae CPSUCNG 
H Max RU size, lower limit 2 

Max RU size, upper limit | 3 
Max negotiable session limit 2 
Current session linit 2 


PS 
56 
12 


LEEW Wn 
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Visual 13-3. Display Active SNA Configuration 


e This is just one of the many items that can be displayed with the Display Active 
SNA Configuration function. 


e Just about everything related to SNA communications can be displayed. 


¢ The display tool can also be used to display the SNA configuration of a remote 
system. 

e The remote system must have an program called RDSPSRVR installed in the 
default transaction program path or have an explicit transaction program definition 
for the program. 


Note: The RDSPSRVR program is installed when you install the utilities from the 
Additional features option of REINST. 


—————— 
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SNA Logical Link Services 


| Display Change status Options Help 
H Partner 
Network Partner Partner Preferred Active Link 
ID Name Type Server Sessions Status 
AAAAAAA USIBMES.ESTICNM LEN No 3 
NKO001 USIBMES OS28064 EN No 
INKOOO2 USIBMES ATL LEN No Inactive 
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Visual 13-4. SNA Logical Link Services 


With SNA Logical Link Services, you can: 
* Activate inactive links 
¢ Deactivate active links 
¢ Display detailed information on a specific link 


Just select the link you want to work with, and select an action from the action bar. 
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SNA Logical Link Services 


Fully qualified partner na 


CP sessions supporte 
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Visual 13-5. Detailed Link Information 


¢ This is an example of detailed link information. 
¢ This particular link is an implicit link to a 370 host. 


e Implicit links will be prefixed with an @ sign. 


_oOo 
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Session Services Menu 


. Display sessions 

. Display gateway sessions 

. Change APPC session limits 

. Immediate deactivation of APPC session 


ees ese Y 


AWN PR 


Esc=Cancel Fi=Help 
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Visual 13-6. Session Services Menu 
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Display Sessions 


Ld 





Select a list number and press Enter to display detail data. 


An asterisk (*) in the List Number indicates an active LU 6.2 session. 


List Partner Mode LU OLC 
Number LU Alias LU Alias Name Type Type 

1% 0S28664 STLOUIS QPCSuUPP LU 6.2 

2 0S28864 STLOUIS SNASVCHG LU 6.2 

an 0828664 0S28664N CPSVCMG LU 6.2 

4* 0828864 0S28664N CPSVCMG LU 6.2 

5 A LU 2 IBMTRNET 

6 B LU 2 IBMTRNET 


Esc=Cancel Fl=Help 
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Visual 13-7. Display Sessions 


e An asterisk precedes any active session. 


; Display APPC Detail Session Data 








Lists MUMber sce Bote WS Br ew ce Es ee oe ee wD 

MUM ATARSe es bh hae & Berg de aun 4. Go ay S lat ae o OE OS28864 

CU MAME See ye ie ca ee te? a Ewe WOE Be cde we : 0828864 
Partner LU alias. 6 eee ge we a ee a gw aw f OSTLOUIS 
Partner fully qualified LU name... ........ . : USIBMES.STL 
Mode name sk cg ee a ae a eee EH Hw we we > QPCSUPP 
Type of connection. . 2... 2... 2 2 ee ee ee ee et PU 2 
Current mode session limit... 2... .....6...-. 32 64 

SSCP-LU session status... 2... 1... ee eee eee : NONE 

Active conversation 10. 1.06 66 ss we hee ow we ae Y GREZTFCE 
DE Ce Ty Pei. ch 2 eit a sat ee wl Ha as a ad ew we tae Sa at : 

Adapter MuUMDeM's: ia cs 2 gs fete ae Sa ah ee es SS : 6 

CIV CUS CURE eos eR ee Ge eee eS ce i 8 

LINK HONE 6 ak eee ek OE a ee ee ee ee 

Destination Ham, 2 65k eee ww we we we ew i 

Destination address... 2.2... 1 1. ee ws  . 2 468887132622 
Active TP pats 6 6 5k ee ee Re we oe we we 


$256 WORK STATION FEATURE 


Esc=Cancel Fl=Help 
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Visual 13-8. Display APPC Detail Session Data 








e You can get the same LU 6.2 session information, and more, from the Display 


Active SNA Configuration function. 





PV Bamsee tebe IMA ALL aAAn 


Student Notebook 


Change APPC Session Limit Options 


LU. @lTaS.) se ese ene re we Be bdo Se we 8 1OS28064 
Partner LU alias. . . 2... ese eevee . . : STLOUIS 
Mode name . . 2 2 1 ew ww ew ee ew we ww we &)~«6QPCSUPP 


Maximum number of sessions for this mode...... jee ew 6[32767] 
Minimum number of contention winners source. ...... al eeu ee cay E326 3] 
Minimum number of contention winners target. ............ (6 J 


Number of automatically activated sessions ........ ~. es. [8 J 





Enter Esc=Cancel Fi1=Help 
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Visual 13-9. Change APPC Session Limits 








¢ This function allows you to change the session limits between a pair of LUs using a 
particular mode. 

¢ Before you can change session limits, you must set the current number of sessions 
for the mode to zero. That is, you cannot directly change session limits from one 
non-zero value to another non-zero value. 


* Use the Immediate Deactivation of APPC Session function to set the current ses- 
sions to zero. 
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Immediate Deactivation of APPC Session 


Enter an asterisk (*) in a field if you will accept all of 
the names defined in the configuration file for that field. 











LU alias... 1... we wae . ee ss « [0828664 J] 
Partner LU alias. . 1... 2s ee eae [STLOUIS ] 
Mode name... 1... 2 ee «ee « « « (QPCSUPP ] 





Enter Esc=Cancel Fi=Help F4=List 
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Visual 13-10. Immediate Deactivation of APPC Session 


¢ This function will deactivate all of the sessions, using the specified mode, between 
two LUs. 
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Data Link Control Services 
1. Activate data link control... 
> 2. Deactivate data link control... 
Select Data Link Control Type 


. Token-Ring or Other LAN type... 
. [8M PC Network... 


+ X25 


. ETHERAND Network... 


Esc=Cancel F1l=Help 
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Visual 13-11. Data Link Control Services 


e You can activate and deactivate any of your configured data link controls. 


Attach Manager Services 


1. Start attach manager 
» 2. Stop attach manager 


Esc=Cancel Fl=Help 
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Visual 13-12. Attach Manager Services 


¢ Start and Stop is all you can do to the Attach Manager. 
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Topic 13.2. Service Point Application Router and Remote 
Operations Service 


CC rr ————————————————————————————————————————————— eR eee 
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SPA Router/ROP Service 





Command Started Status 


: CHKDSK 12:05:04 PM 10-17-91 Active 





Time Registered 





Application 





Commands Waiting Commands in Prog 


Si ee a eeace Fe 





Sa 


SUBSP ACS 


Visual 13-13. Service Point Application Router/Remote Operations Service 





* Service Point Application Router and Remote Operations Service allow a network 


to be managed remotely from the NetView program. 


¢ Commands can be initiated at a NetView console and they will be executed at a 


remote OS/2 workstation. 
¢ SPA Router is the program that receives the command from NetView. 


It then 


sends it to a specified application, such as the ROP service. The application that is 


to receive the command is included in the NetView command. 


¢ The ROP Service processes the commands. The commands may be any OS/2 
commands that have a command line interface and do not need interactive user 


input. 


¢ These services are installed by placing Extended Services for OS/2 disk 1 into the 


A drive and entering BEAU 29 . 


e A group will be created that contains the two programs. 


e Start The SPA Router first, then the ROPS Service. ROPS must register with the 


SPA Router. 
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SPA Router and ROP Service 


The NETVIEW operator (Bubba) wants to look at the directory on Drive C on PU 
ES21TR6. The ROP Service application name ls REMOTEOP. A password of 
TEXAS has been set up In UPM on ES21TR6. 


NETVIEW Console 
RUNCMD SP=ES21TR6, APPL=REMOTEOP, OP=BUBBA; PASS=TEXAS; DIR C: 





REMOTEOP 
ROP svc 


Appl 





SPA Router 





RUNCMD 


SUBSPAO1 


Visual 13-14. SPA Router and ROP Service Example 


e In this example, you can see how the information is routed: 
— A remote NetView console operator will issue a command to a specific PU. 


— The SPA router receives the command and determines which application 
should process the command. 


— In this case, the ROP (REMOTEOP) service processes the command and the 
result is sent back to the NetView operator. 
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Output from NETVIEW Console 


3 


SUBSPA02 


nae : 
RUNCHD SP=ES21TR6, APPL=REMOTEOP , CP=BUBBA; PASS=TEAAS; DIR C: 


Start of Output (} DIR C: 


The volume label in drive C is 082. 
The Yolume Serial Number is E5B3:7C14 
Directory of C:\ 


10-09-91 11:53a <DIR> 
10-09-91 11:53a <DIR> 
10-09-91 12:11p 83 
10-11-91 3348p 2125 
10-17-91 11:38a 2154 
10-11-91 12:59p 10406 
10-09-91 12: <DIR> 
10-17-91 1: 1500 
10-09-91 12: <DIR> 
10-09-91 11: <DIR> 
6-29-91 4: 7764 
10-09-91 12: <DIR> 
10-14-91 9: 74 


oooocooooco°o°cocoo°oefm 





Visual 13-15. NetView Console Output 


AUTOEREC. BAT 
Conf ig. Bak 
CONFIG. SYS 
ERROR. LST 
IBMCOM 
IBMLVL. INI 
MUGL IB 


STARTUP. CMD 


e The result is displayed on the remote NetView console. 


——_—_-—- 0.00 
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Using SPA Router 


mg Running the SPA Router and ROP Service together provides 
remote operations from the Netview program 


a SPA Router can also route commands to other programs 


like LAN Network Manager 


Router 


LAN 
Mgr 





Operator 


SUBSPAD4 


Visual 13-16. Using SPA Router 


e Just as the ROP service can register with the SPA Router, so can LAN Network 
Manager. 


¢ Commands could then be sent to either ROP Service or LAN Network Manager. 
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Using ROP Service 


w Run Netview/PC Version 1.2.1 or later with ROP 
Service to provide remote operations with Netview 


Netview/ <—p 
PC 





Operator 


SUBSP ADS 


Visual 13-17. Using ROP Service 


¢ The ROP service could register with NetView PC instead of the SPA Router. This 
way you could take advantage of the higher functionality of NetView PC. 
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Unit 14. Problem Determination 


What This Unit is About 


There will come a time when things just don’t work the way they 
should. When this happens, it may be time to turn to the problem 
determination tools that are available to Communications 
Manager. In this unit you you will find out what problem determi- 
nation tools are available and how to use them. We will also 
discuss the IBM service and support that is available for OS/2 and 
Communications Manager. 


What You Should Be Able to Do 


After completing this unit, you should be able to 
e List the problem determination tools that are available. 


e Describe the Network Management functions in Communi- 
cations Manager. 


e Perform a trace on Communications Manager information. 


Access the Communications Manager error log. 


e Use the Communications Manager message log. 


Activate the Communications Manager dump facility. 


Describe IBM service/support for OS/2 and Communications 
Manager. 
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Topic 14.1. Problem Determination 
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Service Coordinator Duties 


gw Establish and maintain problem related records. 


mw Advise users that a Service Coordinator is 
available to help resolve or define problems 
that users cannot resolve using other resources 
available to them. 


@ Use the diagnostics tools provided with OS/2 and 
Extended Services 


@ Interface with IBM. 


PROOVRO1 


Visual 14-1. Service Coordinator Duties 


¢ As an interface to IBM, the service coordinator: 
— Reports suspected Extended Services program defects to IBM. 


— Responds to the IBM Support Center with the results of problem determination 
steps. 


— Receives Corrective Service Diskettes (CSDs) from IBM and helps to install 
them. 


¢ Service coordinators must inform IBM if they are relocated, reassigned, or if a new 
person assumes the responsibilities. 


e Use /BM Extended Services for OS/2 Problem Determination Guide for the Service 
Coordinator, S04G-1006 to work through the problem determination flowcharts. 
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System Administrator 


g Install and configure the Communications Manager. 


g@ Verify the proper operation of Communications 
Manager in the end user environment. 


g Interface with the Network Administrator to 
identify Communications Manager requirements 
such as NETBIOS and IEEE 802.2 protocols. 


PROOVRO2 


Visual 14-2. Communications Manager Systems Administrator 


e Installation includes the determination of the requirements for all users in the 
network and creating configuration diskettes or configuration worksheets for the 
users. 

¢ If Communications Manager is being used by entry-level or first time users, the 
system administrator provides run books or instruction sheets to assist the user in 
performing Communications Manager functions. The information provided is cus- 
tomized to the specific Communications Manager functions being used. 
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Network Administrator 


mw Serves as a network installer, coordinator, 
and analyist by: 


Interfacing with other Network Administrators. 


« Interfacing with the Systems Administrator to 
identify LAN specific Communications Manager 
requirements such as NETBIOS and IEEE 802.2 
protocols. 


PROOVROS 


Visual 14-3. Network Administrator 


¢ The network administrator has the primary responsibility for setting up and main- 
taining the local area network to which the computers are connected. The network 
administrator should be an experienced user or application programmer. 


e Interface with end users to answer questions or resolve problems associated with 
LAN hardware or non-IBM LAN application software. 


¢ Monitoring system performance and fine tuning as necessary to improve perform- 
ance and resolve problems. 


Student Notebook 


Host Computer Personnel 


aw Configure the host system software to function 
properly with the Extended Services program and 
the other components in your network. 


mg Resolve host related problems. 


PROOVROS 


Visual 14-4. Host Computer Personnel 


e Host personnel maintain the midrange and mainframe computers that may be part 
of the network. 
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IBM Support Center 


= Helps to resolve program defects in supported 
software. 


mw Provides trained personnel, experienced in solving 
users' problems. 


a The Support Center researches the problem based 
upon symptoms reported. 


mg The problem cause and solution are then documented. 


PROOVROS 


Visual 14-5. IBM Support Center 


The support center process works as follows: 


FP 
2. 


Service coordinator completes a problem report form. 

Phone IBM support Center and report the problem. The IBM representative will 
ask questions about the problem which can be obtained from the completed PRF. 
IBM Support Center assigned a problem management record to the problem 

IBM will research the problem to find a solution, or determine the cause of the 
problem. 

The Support Center will return a status call within eight hours. 

If the problem is new and unique, IBM will continue to research the problem and 
an Authorized Program Analysis Report (APAR) number will be assigned. Record 
this number on the PRF. 

When the problem is solved, the APAR is closed and the problem cause and sol- 
ution are documented. 


PRF: Problem Report Form 
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Diagnostic Tools 


w Logging Utilities 
gw Trace Utilities 
w Dump Utilities 


w Status Utilities 


PROOVRO7 


Visual 14-6. Diagnostic Tools 


e Use the diagnostic tool in conjunction with the problem determination flowcharts in 
the /BM Extended Services for OS/2 Problem Determination Guide for the Service 
Coordinator, S04G-1006. 


¢ The status utility is the OS/2 PSTAT program which provided information about 
running processes in the system. 


Pe er fms IAA Awan 400K 
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Topic 14.2. Logging Utilities 


a ee ee ee ee 
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Logging Utilities 


w OS/2 Logging Facility 

gw LANTRAN.LOG 

gw Communications Manager Message Log 
= Communications Manager Error Log 


mw FFST/2 Message Log 


PROLOGO1 


Visual 14-7. Logging Utilities 


e The OS/2 logging facility, SYSLOG, is available as a problem determination aid, but 
will not be discussed in this course. 
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LANTRAN.LOG 






LT66873: FFST/2 is installed but is not initialized. LANTRAN.LOG is being created. 
IBM OS/2 LANMSGDD [Beta 69/63/91] 1.61 is loaded and operational. 


IBM OS/2 LAN Protocol Manager | 


IBM OS/2 LANDD [Beta 69/63/91] 2.61.2 

IBM OS/2 LANDLLDD 12/12/96 17.12 

IBM OS/2 LANDLLDD is loaded and operational. 

IBM OS/2 NETBEUI 2.61 

IBM - IBM Token-Ring Network Driver, Version V.2.62 

IBM Token-Ring adapter data rate is 4 mbps. 

IBM LANDD is accessing IBM 862.5 LAN Interface. 

Adapter 6 was initialized and opened successfully. 

Adapter 6 is using node address 466667171646. 

IBM LANDD was successfully bound to MAC: IBMTOK_nif->VECTOR. 
IBM OS/2 NETBIOS 3.6 

Adapter 8 has 35 NCBs, 8 sessions, and 7 names available to NETBIOS applications. 
NETBIOS 3.8 is loaded and operational. 

IBM OS/2 LAN Netbind 












PROLAN61 





Visual 14-8. LANTRAN.LOG 


e Information about the initialization of a LAN workstation is stored in the 
LANTRAN.LOG file. 


¢ This file is created new each time the system is booted. 
e The command: 

DEVICE=C:\IBMCOM\LANMSGDD.OS2 /1:C:\IBMCOM 

controls the LANTRAN.LOG file: 


— /\: determines where the LANTRAN.LOG file will be written 
— /P: disables the pause on error function 
— /S: turns off the message display. Message will still be logged though. 


¢ The LANTRAN.LOG can be viewed with the TYPE command or with an editor to 
investigate suspected LAN communications problems. 


¢ If FFST/2 is installed, this information will be logged there as well. 


—— CO 
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Message Log 


Display Messages 


To view all messages in the current log, press Enter. 


To view messages in another log or only certain messages in any log, type 
in your choices and press Enter. 


Message log name. ..... 
(MESSAGE. DAT 


Message date. [18] - [22]- [91] 
Message time. .... piece: (Pel J 


Type the name of an originator, leave blank for all originators, or press 
F4=List to select a name from a list. 


Originator. ....... « «s+ ([3276EH ] 


Enter Esc=Cancel fFil=Help F4=List 


PROMSG61 





Visual 14-9. Message Log 


¢ The Communications Manager message log is used to: 
— Save Communications Manager messages, and related help information for 
later reference when the messages: 
— Are not associated with the current application, screen or panel. 
— Are produced by Communications Manager applications that generate mul- 
tiple messages or require a record of messages that have been generated. 
— Store messages that are associated with user applications that contain the 
LOG_MESSAGE verb. 
e It provides a sequence of events or errors that led to a particular event or 
problem. 
¢ The name, size, and wrap characteristics of the message log file are specified in 
the workstation profile and auto-start options. 
e Only messages that were logged after the specified date and time will be dis- 


played. 

e Messages can be restricted to a particular originator.. Press [F4] for a list of origi- 
nators. 

¢ The message log file can be deleted while Communications Manager is not 
running. 
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Message Log Display 


Log name... ..... : 
MESSAGE. DAT 
Activated. . 2... 2... : 16-23-91 13:31 


To get help information for a message, place the cursor on 
the message number and press Fl. 


Message number. ....... ACS0608W 


A Systems Network Architecture (SNA) error occurred in 5258 Work 
Station Feature session 61. Session 61 stopped. 





Date/Time... . . . . : 16-22-91 13:58:36 
Originator. ...... : S256WSF 





Esc=Cancel Fl=Help F7=Backward F8Forward 


PROMSG@2 
Na re a Se st 


Visual 14-10. Display of Message Log 





Message Log Display 


Log name 
MESSAGE. DAT 
Activated 
Message Help 
To get help information for a messa 
the message number and press Fl. CAUSE: Systems Network Architecture 
(SNA) reported a hardware or protocol 
Message number error. 
A Systems Network Architecture (S 
Station Feature session 61. Sess} ACTION: Restart the 5256 Work 
Station Feature (WSF). If the 
problem persists, contact your 
service coordinator. 


Date/Time 
Originator 


Esc=Cancel Fl=Help 


PROMSG63 





Visual 14-11. Help for messages 


¢ Help is available for all messages. Just locate the cursor at the desired message, 
and press the [F1] key. 


e The message log can be printed with the OS/2 print command. 
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Error Log 





Error Log Services 
Log name. ......se.e 

ERROR.DAT 
Activated ........ 3 16-23-91 13:31 


> 1. Display error log... 





Error Log Display Criteria 





Log name... 2.2 ee 
[ERROR.DAT 
Log type... ...s [eee] 
From date. ...... [16] - [23] - [91] 
From time. . 2... 2. [13] : [31] 


Enter Esc=Cancel Fi1=Help 





PROERR@1 


Visual 14-12. Error Log 





















¢ One of the primary uses for the error log is to store Communications and Network 


Management data whenever an alert is generated. 


e A complete copy of any alert is also logged in the error log. This is useful for later 
reference in case the host link was not active and the alert never arrived. 


e The name, size, and wrap characteristics of the error log file are specified in the 


workstation profile and auto-start options. 


e Only errors that were logged after the specified date and time will be displayed. 


e Errors can be restricted to a particular type. Press [F4] for a list of types. 


e The error log file can be deleted while Communications Manager is not running. 


¢ The error log file is in binary format and cannot be viewed or edited outside of 


Communications Manager. 


AA AA OP we net 
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Error Log Display 
log name... .: 
ERROR. DAT 
TypPh ch eae eR eww we ewe eS OAT? 
Sub type... 1 1 ee eee ee ew ee ee 2 «(08888882 
Date/Time. . 2... 2 1 ee ee ee we ew et) 16-23-91 = 87:23:37 
Originator. 2 2 1 1 we ee ee ee ee tT BMTRNET 
Conversation ID... ........4.. =. : 06666688 
Process ID. 6 2 ww et wee tt ew ws : 1168 
Error data. 6 es oe ee ew : 
4163806666666666616866666B9260006133685B8F5BA764932167499666612167F 617 
0A8133612818318332C6668221616660318221368662600866863868G0888EREEEEEFF 


616F666286666681066016E20F61606689676866106866531618616161661B65191688 
G9D6E2F2FSFOF6F44068398906E2F2F8FOFG6F40566F41A516462614568634660671718 
4668644 666866496606465627668528362846384641E8C64616F106362666403618884 
04618663658863866664076889683686FGA816816586A176717254A16663111646E62F5 
FOF6FOF3F3F6FGF2FLF3IFO2GG606E261F246C5C546C3D6D404E405C9C3C1E3C9D6DSE2 
4804C70946464646161163136611FSF5F7FOFOFOFOFOFGFEFOFOFGFEFaFE2626262628 
2826262626262626262626262628282626262826282628282626262826262626262628 


Esc=Cancel Fl=Help F7=Backward F&=Forward 


PROERRG2 











Visual 14-13. Error Log Display 


e This error of type 0017 is an alert. 


e Use the /BM Extended Services for OS/2 Programming Services and Advanced 
Problem Determination for Communications, S04G-1007 to interpret the data in the 


error log. 


Error Log Services 


ERROR. DAT 


Activated 16-23-91 13:31 


al. Display error log... 
> 2. Print error log... 


Error Log Print Criteria 


[ERROR. DAT 


Log type [e660] 


From date (16]-[23]-[91] 
To date (16]-[23]-(91] 


From time [13]: [31] 
To time (14]: [23] 


Enter Esc=Cancel Fl=Help 


PROERRG3 


Visual 14-14. Error Log Print 


¢ This is the only way to print the error log file. 
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First Failure Support Technology/2 


g Software RAS tool 


mw Packaged with EXTD/2 1.0 and LS/2 2.0 


PROFSTO1 


Visual 14-15. First Failure Support Technology/2 


¢ FFST/2 is unconditionally installed and activated whenever the Extended Services 
for OS/2 is installed. FFST/2 is also packaged with the LS 2.0 product. The instal- 
lation program will detect the current version of FFST/2 that is installed, and will 
only install a more recent version. 


RAS Reliability, Availability, and Serviceability 
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FFST/2 Utilization 


= Communications Manager does not utilize FFST/2. 


m LAN Adapter and Protocol Support uses FFST/2 
to log error messages. 


m Database Manager uses FFST/2 for the creation of 
error log entries. 


PROFSTO2 


Visual 14-16. FFST/2 Utilization 


¢ The information that is logged in the LANTRAN.LOG file is also logged in the 
FFST/2 log if FFST/2 is active. 
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FFST/2 Capabilities 


w Customized dump 


w Error logging 
w Generic alert 
mw Message service 
mg Console services 


w Routers 


PROFSTOS 


Visual 14-17. FFST/2 Capabilities 


FFST/2 selectively provides many RAS functions required by both OS/2 applications 
and OS/2 system software: 


Customized Dump: FFST/2 can collect and dump storage areas and/or files selected 
by the calling application. 


Error Logging: FFST/2 can construct a symptom record which uniquely identifies the 
error detected and places it in the OS/2 system error !og. 


Generic Alert: FFST/2 can build and forward a software generic alert that describes 
the error detected. This alert will include key segments of the symptom record built 
by the FFST/2 error logging facility. 


Message Service: FFST/2 can retrieve and log application-specified messages from 
NLS message files. FFST/2 can also, optionally, display the message using the 
FFST/2 Message Console Facility. The message display can be turned off by the 
user through the FFST/2 Initialization/Configuration program. 


Console Services: FFST/2 also provides a PM message control facility that maintains 
a scrollable copy of all messages logged or displayed by FFST/2. 


Routers: The FFST/2 Router provides the path to send the generic alerts. The generic 
alerts will be routed by Communications Manager over an SNA link or over a LAN 
to the IBM LAN Manager. Both paths end at NetView and may then use the FFST/2 
Service for both hardware and software RETAIN support. 
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FFST/2 Operations 


mw Enable/disable of FFST/2 functions 

w Enable/disable display of FFST/2 messages 
mw Control max number of dump data sets 

w Select target location of dump data files 


mw Select path and filename of FFST message log 


PROFSTO4 


Visual 14-18. FFST/2 Operations 
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Topic 14.3. The Trace Facility 
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Trace Utilities 


w OS/2 System Trace Utility and Formatter 


mw GDDM-OS/2 Link Trace 


mw Communications Manager Trace Services 


PROTRCOS 


Visual 14-19. Trace Utilities 


¢ The OS/2 system trace utility is available for problem determination purposes. 


¢ GDDM-OS/2 Link trace is enabled by running the GQFTRACE program. When it is 
run, it will trace all information related to the GDDM-OS/2 Link product. It can be 
used for GDDM-OS/2 Link problem determination. 
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Trace Services 


@ Trace services is used to diagnose a communications 
problem with a particular function or user written 
application by recording, or tracing a sequence of events. 


@ Trace Services can be accessed through: 


- The Trace Services Menu interface. 
- The command line interface commands. 
- The Common Services API. 
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Visual 14-20. Trace Services 


e The active configuration file must not be locked if you wish to perform trace ser- 
vices. 
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Trace Services 


Trace status : Stopped 
Wrap count + 2 


> 1. Select traces 
. Start selected traces 
. Stop traces 
. Copy storage trace to file... 
. Trace storage size... 
. Auto-trace services... 


Esc=Cancel Fl=Help 
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Visual 14-21. Trace Services Main Menu 


Trace Services 


Trace status : Stopped 
Wrap count : 


>» 1. Select traces 
Trace Type Selection 


Use the spacebar to select, specify a 
trace record length, and then Enter. 


> Trace selections 
a Advanced trace selections 


Trace record length 


Enter Esc=Cancel Fl=Help 
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Visual 14-22. Selecting Traces 


e You can select Normal Traces and/or Advanced Traces. 


e¢ The trace record length is used to determine the amount of trace data that will be 
saved. If you leave the value at 0, the all date will be saved. The maximum is 
12000 bytes. 
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Trace Selections 


Use the spacebar to select one or more, then Enter. 


APIs Data 
e APPC = DFT 
« ACDI «e IBMPCNET 
e SERVICES e SDLC 
a SRPI e IBMTRNET 
a X.25 e X.25 
= EHLLAPI a TWINAXIAL 
# LUA_RUI a X.25 FRAME... 
# LUA SLI = ETHERAND 
= SUBSYSM 











Enter Esc=Cancel Fi1=Help 
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Visual 14-23. Normal Trace Selections 


¢ These are the traces you can select with the Trace Selections option. 


e The API trace will trace the interface calls that are made by an application to the 
selected API. For example, when an MC_ALLOCATE verb is issued, the APPC API 
trace will have an entry. 


e The data traces will trace all Packet Information Units (PIUs), that come in or go 
out of the specified DLCs. 
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Advanced Trace Selections 
Use the spacebar to select one or more, then Enter. 


System Events 


EVENT 
EVENT 
EVENT 
EVENT 
EVENT 
EVENT 
EVENT 
EVENT 
EVENT 
EVENT 
EVENT 
EVENT 
EVENT 
EVENT 
EVENT 36 


EVENT 
EVENT 
EVENT 
EVENT 
EVENT 
EVENT 


Enter Esc=Cancel Fil=Help 
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Visual 14-24. Advanced Trace Selections 


¢ The advanced traces are meant to be used under the direction of IBM Support 
Representatives. 


¢ Each event will trace a particular activity. 


e The Support personnel know which event does what. 
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Auto-trace Services 










Auto-trace status ........... : Disabled 


> 1. Select and store auto-traces 
« 2. Enable auto-trace 

3. Disable auto-trace 
= 4, Trace storage size... 








Esc=Cancel Fi1=Help 
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Visual 14-25. Auto-trace Services 


¢ Auto-trace is used to activate traces as Communications Manager is starting. 


The auto-trace is useful to trace Communications Manager start-up information. 


¢ Link activations and early API calls are good candidates for auto- trace. 


¢ Don’t forget to disable the auto-trace when you are through, or the trace will be 
active every time you start Communications Manager. Performance will be 
affected. 
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CMTRACE 










CMTRACE 
(C) Copyright IBM Corporation 1998, 1991 
























Usage: 
CHTRACE START flags Start one or more trace categories 
CMTRACE STOP flags . Stop one or more trace categories 


CMTRACE COPY flags file Copy a trace to a file 


The flags are: 
/api, followed by one or more (blank separated) of: 
ACDI, APPC, EHLLAPI, LUARUI, SERVICES, LUASLI, SRPI, SUBSYSM, X25, 
X25 FRAME 
/data, followed by one or more (blank separated) of: 
DFT, ETHERAND, IBMPCNET, SDLC, IBMTRNET, TWINAXIAL, X25 
/event, followed by one or more (blank separated) numbers between 1 and 36 
/key, followed by a 1-8 character key 
/reset resets the trace buffer. Previous trace records are lost 
/stdout write the trace data to standard output 
/storage <n>, where <n> is number of 64KB segments for trace buffers 
/trunc <n>, where <n> length at which trace records are truncated 


The flags that can be used with the various operations are: 
AUTOSTART /key, /api, /data, /event, /trunc, /storage 
START /key, /api, /data, /event, /reset, /trunc, /storage 
STOP /key, /api, /data, /event 
COPY /key, /stdout 


Case is immaterial in all flags and keywords. Flags and keywords may be 
abbreviated so long as they remain unique. 
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Visual 14-26. CMTRACE 


¢ CMTRACE is the command line interface to activate traces. 


e The use of the menu interface vs. the command line interface will be mainly a 
matter of personal preference. 


¢ The command line is often just plain faster for an experienced user. 


e The only thing you cannot do from the command line is to control the trace wrap: 
count. You need to use the menu interface for that. 
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FMTTRACE 









FMTTRACE 
(C) Copyright IBM Corporation 1996, 1991 














fmttrace [/flags] file 
where flags are: 
D(d) - produce (don't produce) a detail file 
S(s) - produce (don't produce) a summary file 
A(a) - format (don't format) the API trace 
P(p) - format (don't format) the CPI-C trace 
F(f) - format (don't format) the line flow trace 
R(r) - format (don't format) TestRTS 
T(t) xxxxxxxx - include (exclude) verbs with matching TP ID 
C(c)Xxxxxxxx - include (exclude) verbs with matching conversation ID 
L(1)xxxxxxxx - include (exclude) flows with matching LFSID 
H(h) - use uppercase (lowercase) alphabetics in hex output 
the default flag setting is /SdAPFRh 


file is the name of the input trace file. The file extension defaults to .trc. 
If the D flag is specified, a file with the same name and extension .det is 
produced. If the S flag is specified, a file with the same name and extension 
.sum is produced. If the file is specified as '-', input is read from stdin 
and the output files, if any, are fmttrace.det and fmttrace.sum 
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Visual 14-27. FMTTRACE 


FMTTRACE is a utility provided with Communications Manager that formats trace 
information. 


e Formatted traces are much easier to read. 
e There are several formatting options available. 


e Examples of formatted and non-formatted traces follow. 
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Unformatted Trace 


<=SEND=—— + IBMTRNET #66 46668664666664 DAD2B7D614873DAC 16:28:55:28 


#:6658 TH:2C@663626865 RH: 6B9GAG 


346562FF 66630166 6667C1D7 D7C3E2D9 
ES66186F E4E2C9C2 D4CSE24B DGE2ZF2F8 
FOF6F4A4 B16AD416 SF@66168 DCDAB708 
39873DAC 661312FF 48656C76 284D722E 
2657697A 617264 


oeeeds. eAPPCSR> 
<V.. .USIBMESKOS28> 
<664u.jM. ....00e> 
<9g=.....Help Hr.> 
< Wizard > 


==RECV=——=> + IBMTRNET #66 46668664666864 DAD2B70614873DAC “16:28:56:78 
#:664A TH:2C6662636665 RH:639661 


604112FF 4472697A 7A6C6528 4472617A 
7A6C6526 44726162 6C652644 726F6E65 
2E265469 60652666 6F722674 68697328 
6F6E6526 746F2663 6F6D6526 686F6D65 
2E 
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Visual 14-28. Unformatted Trace 





<.A..Drizzle Draz> 
<zle Drable Drone> 
<. Time for this > 
<one to come home> 
<. > 


¢ This is an unformatted trace of data on the Token-Ring DLC. 


Note: The directional arrows indicate incoming vs. outgoing data. 
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Detailed Trace Formatting 


FMTTRACE 
(C) Copyright IBM Corporation 1996, 1991 


Line: 2 Send HU 
Time stamp: 16:28:55:28 
DLC type: IBMTRNET ~ 
Adapter number: 68 
Destination address: 46668664666664 
ALS ID: DAD2B7D614873DAC 
TH: FID2, OIS, LFSID=6x66362, SNF=6x6665 
RH: RQ, FMD, FI, OIC, RQE1, BB, CD 
FMH-5 
Command code = Attach 
User ID already verified = No 
PIP present = No 
Conversation type = Mapped 
Synchronization level = None 
Transaction program name = APPCSRV 
Logical unit of work identifier: 
LU name = USIBMES.0S28664 
Instance number = @xa4b16ad4165f 
Sequence number = 6x6661 
Conversation correlator = @6xdcdab7d639873dac 
Application data 
Hex dump: 
48656c76 264d722e 2657697a 617264 <Help Mr. Wizard > 


Line: 18 Recv HU 

Time stamp: 16:28:56:78 

DLC type: IBMTRNET 

Adapter number: 66 

Destination address: 46668664666664 

ALS ID: DAD2B7D814873DAC 

TH: FID2, OIS, LFSID=6x66362, SNF=6x6685 

RH: RQ, FMD, OIC, RQE1, CEBI 

Application data 

Hex dump: 

4472697a 7a6c6526 4472617a 7a6c6526 <Drizzle Drazzle > 
44726162 6c652644 726f6e65 2e285469 <Drable Drone. Ti> 
6d652666 6f722874 68697326 6f6e6526 <me for this one > 
746f2663 6f6d65268 686f6d65 2e <to come home. > 
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Visual 14-29. Detailed Trace Formatting 


¢ This is the identical trace data, after being run through the trace formatter. 


¢ This is a detailed trace which is created by using the /D option of the trace for- 
matter. 
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FMTTRACE 
(C) Copyright IBM Corporation 1996, 1991 


-Line- --TpId-- 
-Line- --DLC--- 


1434afdé 
1434afd6 
1434afdé 
1434afd@ 
1434afd6 
1434afdé 
IBMTRNET 
IBMTRNET 
1434afdé 
1434afd6 
1434afd8 
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Summary Trace Formatting 


-Convid- 


--HcAl locate (0S28664N, #INTER, APPCSRV) --> 

dcdab7d6 -McAllocate 
dcdab7d8 
dedab7d8 
dcdab7d6 
66 46668664668684 66362 FMHS, App] Data: 
66 46668664666664 66382 ApplData 
dcdab7dé8 <-----HcRevWait (6x8669, 6x66606668) 

TPEnded(Soft) 





Visual 14-30. Summary Trace Formatting 


e This is an 
¢ Both data 


example of a summary trace created by the trace formatter. 
and APPC API data have been captured with this trace. 


¢ The two data flows are the same data flows from the previous examples. 


Note: Notice that the Allocate and data are not actually sent when the verbs are 
issued. They are held in a buffer until a verb that flushes the buffer is issued. 


That verb 


is the McRcvWait. 
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Topic 14.4. The Dump Facility 
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Dump Utilities 

~ 
Pm s 

w Standalone Dump Utility 

w FFST/2 Dump Utility 

mw Communications Manager Dump Services 
ra) 

PROOMPOS 
5 Visual 14-31. Dump Utilities. 
ee ¢ Only the Communications Manager dump facilities will be discussed in this class. 
¢ Communications Manager dump services is a menu-driven utility that makes a 

a copy of a portion of memory used by Communications Manager. 


¢ The results of a dump are meant to be analyzed by IBM Support personnel. 


¢ Dump services can also be activated by an application program through the 
rT common services API. 


¢ The active configuration file must not be locked if you wish to perform dump ser- 
vices. 
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Dump Services 










> 1. Select components to dump 
e 2. Destination for dump data... 
3. Activate dump... 










Esc=Cancel Fl=Help 
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Visual 14-32. Dump Services 






Dump Selections 


Use the spacebar to select one or more; then Enter. 














Component 
= Component 81 Component 16 
a Component 62 Component 17 
« Component 63 Component 18 
= Component 64 Component 19 
a Component 65 Component 26 


Component 66 
Component 67 
Component 68 
Component 69 
Component 18 
Component 11 
Component 12. 
Component 13 
Component 14 
Component 15... 






















Enter Esc=Cancel Fl=Help 






PRODMP62 






Visual 14-33. Dump Selections 


¢ The IBM Extended Services for OS/2 Messages and Error Recovery Guide, 
$04G-1017 contains information on which component to dump for a particular situ- 


ation. 


e IBM Support personnel has this information as well. 
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Dump Services 


ae 1. Select components to dump 
> 2. Destination for dump data... 


Dump Destination 


Dump file name 
(E:\DUMP. DAT 


Enter Esc=Cancel Fl=Help 
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Visual 14-34. Dump Destination 


¢ Use the full path for the dump destination. Otherwise, it will go to C:\CMLIB. 






Dump Services 


a 1. Select components to dump 
« 2. Destination for dump data... 
>» 3. Activate dump... 


A dump is about to be started. Minimal system activity 
is recommended. No transaction programs should be 
started. All traces will be stopped. 


Oo you want to continue? 


al. Yes 
> 2. No ACS6624W 

















Esc=Cancel Fl=Help 
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Visual 14-35. Dump Services (part 4) 


e All traces are stopped during a dump. 





© Copyright IBM Corp. 1992 Unit 14. Problem Determination 14-35 


Student Notebook ; 
fa ee ee 


ee 


@ Canvriaht IBM Corp. 1992 . 








ACDI: 
API: 
APPC: 
BCS: 
C & SM: 
CCITT: 
CICS: 
CM: 
CPI-C: 
CSD: 
CSI: 


CSMA/CD: 


CUT: 
DBCS: 
DCA: 
DCE: 
DFT: 
DIA: 
DIF: 
DLC: 
DTE: 
ECF: 
EHLLAPI: 
GDDM: 
IEEE: 
ISO: 
LAA: 
LAN: 
LU: 
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Appendix A. Common Acronyms 


Asynchronous Communication Device Interface 
Application Programming Interface 

Advanced Program to Program Communications 
Basic Configuration Service 

Communication and System Management 
International Telephone Telegraph Consultative Committee 
Customer Information Control System 
Communications Manager, also Comm Mgr 
Common Programming Interface - Communications 
Corrective Service Diskette 

Common Service Interface 

Carrier Sense Multiple Access / Collision Detection 
Control Unit Terminal 

Double Byte Character Set 

Document Content Architecture 

Data Circuit Terminating Equipment 

Distributed Function Terminal 

Document Interchange Architecture 

Data Interchange Format 

Data Link Control 

Data Terminal Equipment 

Enhanced Connectivity Facility 

Emulator High Level Language API 

Graphical Data Display Manager 

Institute of Electrical and Electronics Engineering 
International Standard Organization 

Locally Administered Address 

Local Area Network: 


Logical Unit 
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LUA: 
MAC: 
NAU: 
NCP: 
NDIS: 
NMVT: 
NPSI: 
OIA: 
OSI: 
PSDN: 
PU: 
QLLC: 
RDS: 
RH: 
RU: 
SAP: 
SNADS: 
SQL: 


SQLLOO: 


SRPI: 
SSCP: 
TCP/IP: 
TP: 
TSAF: 
UPM: 
VTAM: 
WAN: 
WSF: 


nN 


Conventional LU Application Access Method 
Media Access Control 

Network Addressable Unit 

Network Control Program 

Network Device Interface Specification 
Network Management Vector Transport 
NCP Packet Switching Interface 

Operator Information Area 

Open System Interconnect 

Packet Switching Data Network 

Physical Unit 

Qualified Logical Link Control 

Remote Data Service 

Request/Response Header 
Request/Response Unit 

Service Access Point 

SNA Distribution Service 

Structural Query Language 

SQL LAN Only Option 

Server Requester Programming Interface 
System Services Control Point 
Transmission Control Protocol / Internet Protocol 
Transaction Program 

Transparent Service Access Facility 

User Profile Management 

Virtual Telecommunications Access Method 
Wide Area Network 


Workstation Feature 
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Lab 1. Communications Manager Installation 


What This Unit is About 


During this lab, you will get a chance to use several of the 
Extended Services for OS/2 installation tools. You will install the 
Communications Manager, Create a custom install diskette, install 
the Communications Manager utilities, and use the programmable 
configuration tool. 


What You Should Be Able to Do 


After completing this unit, you should be able to 


¢ Install Communications Manager using Basic Configuration 
Services. 


¢ Create a Custom Install Diskette. 
e Use the REINST utility. 


¢ Use a Programmable Configuration exec to modify an existing 
configuration file. 
Required Materials 


You will need the following materials to complete this lab: 
¢ This lab guide. 
e Extended Services for OS/2 diskettes. 


¢ One blank, formatted diskette. 
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Topic 1.1. Installation 


Note: Normally you would use the ES diskettes for all ES installs; however, 
this is time consuming. In order to save you time in the lab, we have 
“COPIED’ all the ES diskettes into a directory called C:\ESDISKTS\. All the 
processes that follow are exactly the same but instead of having you feed 
diskettes, the code will be extracted out of the C:\ESDISKTS\ directory. 


1. Begin the install process by entering ‘C: \ESDISKTS\ESINST at an OS/2 
command prompt. 


2. Choose the Basic Configuration and Installation option, when prompted. 


3. Call your configuration file (y@aag . 


4. Configure one 3270 LAN terminal session, no printer, and make sure to auto- 
start it. 

5. Configure for the following: 
Note: Refer to APPENDIX A for configuration information. 


e IBM Token Ring Network 

e Adapter = 16/4/A (Not Bus Master) 

Specify a Locally Administered Address 

Local LAN Adapter Address = 4000003681xx 
3270 Host Session 1 address =02 

¢ Specify a Destination Address = 400009103689 
¢ Local Node Name: OVTNEx 

¢ Network ID = CANEDES 

¢ Local Node ID 


6. If you had other items to configure, you could do that now. Since you are 
done configuring, just press [F3] to begin the installation. 


7. Be sure to install onto the C drive when asked. 
IMPORTANT: DO NOT INSTALL DATABASE MANAGER. 

8. Eventually, you will be presented with the IBM Extended Services 
Install/Remove Menu. If you wanted to install Database Manager, you would 


select it now. You are not going to install Database Manager, so just press 
[F3] to complete the install process. 


9. When the Install/Remove Complete panel appears, remove any diskettes from 
the A drive, shutdown and reboot the system by pressing [Ctrl +Alt+ Del]. 
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__ 10. When the system comes back up, look at the new groups that have been 
added to your desktop. Look at the contents of them as well. 


11. Start the Communications Manager to see if your 3270 session works. 


Note: Start the Communications Manager by double clicking the entry in the 
Communications Manager group. 


e When you are prompted for a configuration file to use, enter your (j\faie 
file. 


¢ Your 3270 session should appear on the screen. 
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Topic 1.2. Creating Custom Install Diskettes 


1. 


10. 


11. 


Aes 


13. 


14. 


1-4 


Insert your blank, formatted diskette into the A drive. 


Note: If you do not have a diskette, see an instructor. 
Invoke the Custom build utility in one of the following ways: 


e Enter falbygjii} at an OS/2 command prompt. 
¢ Double click on the entry in the Extended Services group. 


Include Communications Manager on your Custom Install Diskette. 


Specify the drive letter you would be installing Communications Manager onto. 


Note: If you will want to actually test your Custom Install Diskette, use the C 
drive. 


You must include at least one configuration file on the Custom Install Diskette, 
so select the Configuration Files option. 


The directory is C\CMLIB. 


Select MYCFG as the configuration file. 


. Choose the Additional Features option. 


Add any of the additional features that you want. 
Press [F3] to exit the Communications Manager Custom Build Menu. 


lf you wish to include Database Manager on your Custom Install Diskette, you 
would select Database Manager at this time. 


When you have added all the components you want, press [F3] to exit the 
CUSTBLD program. 


You now have a Custom Install Diskette that, when used, will install all of the 
features you specified. 


IMPORTANT: DO NOT INSTALL THE CUSTOM INSTALL DISKETTE AT THIS 
TIME. You may test it, if you wish, after the final lab at the end of the week. 


Use the DIR command to look at what was placed on the A diskette. 
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Topic 1.3. Installing the Communications Manager Utilities 
The Basic Configuration Services option did not allow you to install the Communi- 
cations Manager Utilities. You need to use REINST to get these tools installed. This 
is done through the Advanced Features option of REINST 

1. Invoke the REINST utility in one of the following ways: 


e Enter Eiaiikyg at an OS/2 command prompt. 


¢ Double click on the entry, Add or Remove Features, in the Extended Ser- 
vices group. 


2. Choose Communications Manager at the IBM _ Extended _ Services 
Install/Remove Menu. 


3. Choose Additional Features 
4. Choose Utilities. 


5. When you return to the Communications Manager Install Menu press [F3] to 
install the utilities. 


6. When you return to the IBM Extended Services Install/Remove Menu, press 
[F3] to exit the REINST program. 


7. Because you have changed your communications configuration, you should 
now exit the Communications Manager and restart it. 


8. The utilities are now ready to use. You will find them in the Communications 
Manager group. 
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Topic 1.4. Programmable Configuration 


A REXX program called CFGADD.CMD has been placed in the C:\$7049 directory. This 
program will add 1 session to your configuration. You will examine and execute this 
program in order to see how the programmable configuration tool works. 


1. Using either the OS/2 system editor, or the enhanced editor, view the file 
C:\S7049\CFGADD.CMD. 


Note: The enhanced editor will make it much easier to count line numbers. 
Make sure to change the font to a non-proportional font (Courier or System 
Monospaced). This will make the file more readable. If you use the system 
editor, turn off word wrap. 


2. With the aid of the Programmable Configuration Reference Manual, examine 
the file. Be sure to read the paragraph in the introduction section regarding 
‘VERIFICATION CONSIDERATIONS”. 


3. Make sure that Communications Manager is running. 
4. Execute the REXX program in the following manner: 


¢ Make a working directory called C:\WORKING. 
¢ Change to the C:\WORKING. directory. 
¢ Copy the CFGADD.CMD from the C:\S7049 to the C:\WORKING directory. 


¢ Enter | CFGADD from the C:\WORKING directory. 
Note: The configuration program should be executed from a directory that 
contains all the necessary files i.e. CFG.NDF,CF2 and SEC files. After 
updating, these files are then copied back to their respective directories, 
which completes the process. 


5. You will see a return code from each statement as it executes. If you do not 

get a return code of 0 from each statement, look at the MYCFG.LOG and the 
MYCFG.LG file in the C:\CMLIB directory. These files are created by the pro- 
grammable configuration utility. 
Note: If you already have a 3270 terminal with the same parameters as the 
one you are creating, you will get a non-zero return code from the 3270SNA 
statement. Therefore, if you run this particular program twice, the second exe- 
cution will not have all zero return codes. 


6. You will need to exit the Communications Manager and restart it to see your 
new session. 


7. Now, for an optional CHALLENGE. Change the CFGADD.CMD file so that it 
will prompt the user for pertinent information. 


¢ Configuration file name 


¢ 3270 Session number 
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e 3270 Session name 
e 3270 Short Session ID 
e LU Address 


Note: Use the REXX SAY and PULL commands to prompt the user and read 
their input. Instructions for using the REXX commands can be found in the 
REXX online command reference. 


This concludes the Communications Manager Installation lab. 
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Lab 2. Using 3270 Emulation 


What This Unit is About 


During this lab, you will get a chance to use the Communications 
Manager 3270 emulation. You will experiment with font sizes, set 
up and transfer files to and from the host, remap your keyboard, 
use the clipboard, and use the presentation space printing feature. 


What You Should Be Able to Do 


After completing this unit, you should be able to 
¢ Change 3270 terminal emulation font sizes. 
¢ Use the PM clipboard with 3270 terminal emulation. 
¢ Transfer files between the workstation and a 370 host. 
¢ Remap the keyboard. 


¢ Print from the presentation space. 


Required Materials 


You will need the following materials to complete this lab: 


¢ This lab guide. 
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Topic 2.1. General Use 


In this topic, you are going to get some experience with some of the general use tasks 
that can be performed with Communications Manager 3270 emulation. 


Note: 


In 3270 Emulation, the “enter” and “clear” keys are: 


e “enter” is the Ctl key. 
e “clear” is the Pause key. Use when MORE or HOLDING is displayed. 


Emulator operations 


1. 


z. 


If Communications Manager is not running, start it. 
Start your 3270 session. 


At the LOGO Screen, type TOROCE and “enter’(Ctl key) to get to the VM host 
system. 


Log on to the host with the following information: 


e User ID from your tent card. i.e. OS2IDxx (Where xx = 01 to 20) 


e Use the password provided by your Instructor (You will be prompted 
change it while logging on... Write it down). 


. Experiment with the font sizes and window sizes to see how much space a 


model 2 session takes up. 


Note: The fonts can be adjusted by clicking on the terminal’s system menu, 
choosing Emulator operations and then choosing Font size 


* What is the maximum number of maximized model 2 terminals you can fit on your 
screen at once? . 


* Can you get a model 2 terminal to fill the screen? Wa5 


6. Another option you may want to change is the window maximize style. 


7. Select Window maximize style from the emulator operations dialog box. 


* What is the difference between the two styles? 
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* How can you return to the original style? 


8. Now lets work through a problem situation. Suppose that your operator infor- 
mation area (OIA) was displaying a message that read MACH690 Where can 
you go for help? The first place you may wish to try is Emulator help. 

9. Select Emulator help from the system menu pull down. 


10. Now click on the OIA message help and click the OK button. 


11. Follow the instructions that appear in the help window, and search for help on 
MACH690. , 


Note: Search the index rather than the default of All Sections by clicking on 
the appropriate radio button. Also, do not put a space between MACH and 
690. 


Note: You can move windows that appear on top of the instructions in order 
to continue reading the instructions. 


Clipboard 

1. Pick the 3270 session that you are logged on to and maximize it. 

2. Type some characters in at the cursor position (do not hit enter). 

3. Use the mouse to select as much of the terminal session as you can. This is 
done by holding down mouse button one and dragging the pointer over the 
area you wish to mark. 


4. Go to the 3270 system menu and select Cut. 


* Did all of the text get cut? 


* Why or why not? 








5. Now open the OS/2 System Editor. The easiest way is to enter E | at an OS/2 
command prompt. 


6. Change the font in the OS/2 System Editor to COURIER with a size of eight. 


7. Turn word wrap off and maximize the OS/2 System Editor. 
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8. Choose the Paste function from the Edit pull down. 


9. The text from your 3270 session should appear in the OS/2 System Editor. 


Did the the protected areas of the 3270 terminal get copied? 


Is this what you expected? 


Communications Manager 
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Topic 2.2. 3270 Keyboard Remap 


Now lets configure a keyboard profile called 3270KEYS profile. To do this, you need 
to go to the Keyboard remap section under advanced configuration. 


1. 


2. 


10. 


11. 


TZ; 


13. 


Choose the Communications Manager from the window list (Ctl-Esc). 
Choose Advanced--> Keyboard remap from the pull down. 
The configuration file is MYCFG. 


You want to create a keyboard for IBM 3270 Terminal Emulation. 


. You have an IBM Enhanced 101 keyboard. 


Create a new profile called 3270KEYS. Use the default keyboard profile as the 
model. 


Note: A list of models can be displayed by pressing the [F4] key. 
You don’t need to change anything on the first panel. 
Select the key that represents J and Edit it. 


Make the Alt+J perform a jump function between your 3270 sessions. 
Note: A list of functions can be displayed by pressing the [F4] key. 


Next, edit the PC Enter key so that when you press Enter, the key will generate 
a true 3270 enter function. 


When you are done, choose Exit--> Exit remap--> Save then exit from the 
pull down. 


Note: Notice that verification occurs automatically when you exit keyboard 
remap. If there are any verification errors, look at the Communications 
Manager message log to find out what is wrong. The message log is accessed 
from the Communications Manager Main Menu. 


Change the 3270 Profiles (both sessions) to use the new keyboard profile. Do 
so via Advanced Configuration and the 3270 Feature Profiles. 


Stop and restart the Communications Manager to make your changes active. 
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Topic 2.3. Keyboard Remap Use 
Now lets try out the keyboard profile called 3270KEYS profile. 


1. Try out your Alt+J key combination. This is the key that you remapped to 
perform the jump function. It should jump between all of your started 3270 


terminals. 


* What happens when you jump to a minimized 3270 session? 


* What would happen if you jump to a 3270 session that does not have a jump key 
defined? 





2. Try out your Enter key. 


: Does it perform the correct function according to your remap? 
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Topic 2.4. Color and File Transfer Profiles 


In this topic, you will change the way that the host color codes are displayed on one 
of your terminal sessions. In addition, you will create two file transfer profiles for use 
with the menu driven file transfer option. You will create a profile for transferring text 
files and one for transferring binary files. 


1. Choose Color and alarm via Advanced Configuration. 


2. Change the colors of your A session. 


Note: Make sure to at least change the top four color items. These are the 
colors that the host system uses. Also, be sure to change the background 
color so your changes will be most noticeable. 


3. When you are finished, choose Exit--> Save and exit from the action bar. 
4. Choose File Transfer 


5. Create a new profile called Bjigaqmg. Use the provided model for VM text 
files. 


Note: A list of models can be displayed by pressing the [F4] key. 


6. None of these fields need to be changed for a text file. The model was set up 
correctly already. 


7. Create another file transfer profile called BiQU3a\). This profile will be used for 
binary file transfers. Use the same model as before, but make the following 
changes fo it: 


¢ Set ASCII to/from EBCDIC translation to NO 
e Set Use CR/LF as record separator to NO 


8. When you are finished, press [F3] to return to the Communications Manager 
Configuration Menu. 
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Topic 2.5. File Transfer 


In this 


topic, you are going to send and receive files from a host system. You will use 


the menu driven mode and the command line mode of file transfer. You will also get 
a chance to use the Communications Manager online help. 


Menu 
Note: 


1. 


Mode 
Be sure you are logged on to the host. 


Using the menu mode, send the text file called C:\S7049\3270LAB.TXT to the 
host. 


Note: The menu mode is started by selecting Transfer files from the Commu- 
nications Manager Main Menu. 


. When you are prompted for a terminal to transfer the file through, select the 


terminal you are logged on to. 


. Select Send File. 
. Use your file transfer profile for text files. 
. Call the file 3270LAB SCRIPT A at the host. 


. Write down any messages returned when the transfer completes. 














. Switch to your host session and type FLIST at the command prompt. Edit the 


3270 file by placing an ”x” beside the file name then “enter”. 


* Does the file look ok? _\\(/ 


8. 


a; 


10. 


V4 
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Return to a ready prompt at the host (PF3). 


Go back to the file transfer panel, customize the profile and send the file to the 
host until it transfers without error (see note). 


Note: The records segmented error has to do with the file record length. The 
logical record length of a file can be set by selecting “Customize Profile” and 
modifying the Host File Characteristics. Since you do not know the record 
length of the file, you may want to try a large record length in order to fix the 
error. The help screen will tell you what the maximum record length can be. 


Now, again using the menu mode, receive the binary file called PIANO EXEBIN 
B that has been placed on your VM B disk. 


Use your file transfer profile for binary files. 
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__ 12. Call the file C:\S7049\PIANO.EXE on the workstation. 


__ 13. When the transfer completes, switch to OS/2 command prompt, change to the 


* 


* 


C:\S7049 directory and run the PIANO program. 


Does the program work? eo 


If not, what are some possible reasons, and how can you fix it? 


__ 14. Transfer the file until the program runs correctly. 


Command Mode 


Ts 


2 


Now you will transfer a file using command mode. 


Open an OS/2 Windowed Command Prompt.. 


Note: Make sure it is a Windowed command prompt and not a full screen 
prompt. You are going to bring up the Communications Manager online help 


and in order to be able to view the help while you are entering the file transfer 


command, you need to use a window rather than a full screen. 


Open the Extended Services Command Reference folder. 


Note: This is located in the Extended Services folder. 


. Do a search on SEND 


Note: This will get the help file for the send command. You should be able to 
read the help screen while you key the correct command into the windowed 
command prompt. Move and size the windows so that both are visable on the 
screen. 


Send the text file called C:\S7049\3270LAB.TXT to the host. 


Call the file 3270LAB SCRIPT A at the host. 


Note: Make sure the host is logged on and ready before starting the file 


transfer. 
. Switch back to the host session. 
. Use FLIST as you did before to view the file and ensure it transferred properly. 


. Send the file until it transfers correctly. 
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10. Close the help screen for the send command. 


11. From the Extended Services Command Reference do a search on RECEIVE. 


12. Now, again using command mode, receive the file PIANO EXEBIN A, from the 


host, 


13. Call the file C:\S7049\PIANO.EXE at the workstation. 


14. When the transfer completes, switch to OS/2 command prompt, change to the 


* 


* 


ay 
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C:\S7049 directory and run the PIANO program. 


Does the program work? 


If not, what are some possible reasons, and how can you fix it? 


5. That’s all for file transfer. 
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Topic 2.6. Presentation Space Printing 


In this topic, you will get a chance to see the 3270 presentation space print in action. 
If you configure a logical printer or activate the presentation space print feature in a 
logical terminal, you will have a 3270 Print Control Window when the printer or logical 
terminal is started. 


1. 


Click the mouse on the 3270 Print Control window or use the task/window list 
to select it. 


-~ 
* How many sessions are sharing this window? _ A 


* What session types are they? “le Nina 


2 


Click the mouse on action bar items - Control, Setup, and Configure. Explore 
the contents of each menu. Press [F1] to get help for any field you wish to 
Know more about. 


Now, you will look at how presentation space print is processed from the 3270 
emulation window to the Print Control window to the Print Manager window. 


Arrange your desktop so that the following windows are open and in view: 


¢ One 3270 terminal 
e The 3270 Print Control window 
¢ The IBM 4201 printer 


Note: Use small font sizes and size the windows so that each window can be 
viewed. 


Make sure that you can see the Print Status field of the 3270 Print Control 
window. 


. Click the mouse on the 3270 terminal window and press Shift-Print Screen. 


Note: Notice that the hard disk light flickers as the information is processed. 


* What happens to the 3270 Print Control window? 


ran : 
\\ xh Va) 





* What happens to the Printer window? 








Note: You may Cancel the print job by clicking on newly created print job and 
selecting the Delete action from the context menu. 
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Lab 3. Communications Manager SNA Gateway 


What This Unit is About 


During this lab, you are going to configure and use the SNA 
Gateway feature of Communications Manager. This lab will 
require that you work together with a partner team. While one 
system is acting as the gateway, the other system will act as the 
downstream workstation. 


What You Should Be Able to Do 


After completing this unit, you should be able to 
¢ Configure an SNA Gateway host connection profile. 
¢ Configure SNA workstation LU profiles for dedicated LUs. 


e Use subsystem management to observe gateway links and ses- 
sions during gateway operation. 


¢ Create a downstream workstation for the Communications 
Manager SNA Gateway. 


Required Materials 


You will need the following materials to complete this lab: 


e This lab guide. 
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Topic 3.1. SNA Gateway Configuration 


There are 2 ways to configure the gateway: 
¢ Hard way...Do every profile via Advanced Configuration. 
¢ Easy way...Do 1 session to the host via BCS and then enhance the configuration. 
Since we have already established a session to the host, lets’s do it the easy way! 


1. Team up and work together as follows: 


GATEWAY (Local Node Alias) DOWNSTREAM (Local Node Alias) 


TEAMO1 TEAMO2. 
TEAMO3 TEAM04 
TEAMO05 TEAMO6 
TEAMO7 TEAMO8 
etc. etc. 





The host folks have given each “Gateway” PU 4 sessions, LU addresses 
02,03,04 and 05. During the previous lab, you configured each workstation to 
use 2 of these sessions. You have also verified that the session works. Now, 
you will create a gateway to pass sessions 04 and 05 to a downstream partner 
on the token ring network. 
2. CREATING THE HOST CONNECTION PROFILE 
At the workstation you have chosen to be your gateway, start Communications 
Manager and get it up full screen. Configure as follows: 
e Advanced 
¢ Configuration (use mycfg) 
¢ SNA Feature Profiles 
¢ SNA Gateway Profiles 
HOST Connection 


¢ Create 


e Token Ring Network 

e Permanent Connection = Yes 

e Enter 

e Adapter 0 

¢ Destination Address = 400009103689 

e Enter 

e At page 2 just hit enter to accept all defaults 
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At this point, you have created a logical connection to the host for the 


gateway. 


3. CREATING WORKSTATION PROFILES 


You need to create 1 profile for every LU session that you want to pass down- 
stream. From the SNA Feature Configuration screen, configure as follows: 


e SNA Gateway Profiles 
¢ Workstation LU 


¢ Create a new profile for each LU session. 


created. 


Use the M6 model for the first 
LU session then use that profile as a model for each subsequent profile 


e Accept all defaults except for the following parameters: 














































e When you have finished, verify your configuration. 
— What happened? 
— What do you need to do? 


— Why? 


¢ Stop and Exit Communications Manager 


¢ Go to an OS/2 prompt, type REINST and follow the prompts to properly 
install the new Gateway configuration. When asked to select which Config- 
uration files to use for updating your CONFIG.SYS, choose MYCFG. After 
you have completed the REINST, ensure that you can start Communications 
Manager with no errors. 


Note: You can also get to REINST by selecting the Add or Remove Fea- 
tures ICON in the Extended Services Folder. 


4. CREATING A DOWNSTREAM WORKSTATION 


PROFILE CP NAME (PU | LU ADDRESS LU ADDRESS DESTINATION 
NAME NAME) AT WORK- AT HOST ADDRESS 
STATION 
TEAMxxA (xx OVTNEx (part- 04 LAA of Down- 
= partner) ners PU) stream Work- 
station 
TEAMxxB (xx OVTNEx (part- | 03 05 LAA of Down- 
= partner) ners PU) stream Work- 


station 














e What do you need to change in your 3270 configuration to connect via your 
gateway partner, instead of directly to the host? 


¢ Go to the 3270 Terminal Emulation Profile (using Advanced Configuration) 
and change the destination address from 400009103689 to your gateway 
partners LAA (Appendix A). 
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e Exit and restart your Communications Manager. 


¢ Do you have a host session? How can you verify that it is coming 
from your Partner? 


This concludes the Communications Manager SNA Gateway lab. 
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Lab 4. Advanced Configuration 


What This Unit is About 


Coming into this lab, you should have created a configuration file 
using the Basic Configuration Services and you have used some of 
the Advanced Configuration Services to modify your configuration. 
In this lab you will use the Communications Manager Advanced 
Configuration to create workstation profiles. The knowledge and 
techniques learned here will prepare you for subsequent labs on 
LEN and APPN. 


Remember, once you go into advanced and change a configura- 
tion file, you will no longer be able to use BCS to change the file. 


What You Should Be Able to Do 


After completing this unit, you should be able to 
¢ Load IBM supplied default config files using the REINST utility. 
¢ Configure 3270 Token Ring using Advanced Configuration 
¢ Configure LAN Adapter and Protocol Support. 
¢ Configure a Token-Ring DLC. 


Required Materials 


You will need the following materials to complete this lab: 
e This lab guide. 
e Extended Services for OS/2 diskettes. 


e IBM Extended Services for OS/2 Communications Manager 
Configuration Guide, S04G-1001 


e IBM Extended Services for OS/2 Communications Manager 
Host Connection Reference, S04G-1004 
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Topic 4.1. Loading Default Configuration Files 


In this topic, you will load a default configuration file using the Advanced 
Installation feature of ESINST. 


1. Exit the Communications Manager completely. 


2. In order to remove changes made to the LAN Adapter and Protocol file in the 
previous lab, execute the following program: 


e Enter [RANYAE NS ey 


Note: Cleanup just removes the protocol.ini file, which you will be 
rebuilding during this lab. ; 


3. Initiate the Extended Services installation by entering [AVS Gen Ssilhyg at 
an OS/2 command prompt. 


Note: Normally you would use the ES diskettes for all ES installs; however, 
this is ttme consuming and as mentioned previously, we have “COPIED” all the 
ES diskettes into a directory called C:\ESDISKTS\. All the processes that 
follow are exactly the same but instead of having you feed diskettes, the code 
will be extracted out of the C:\ESDISKTS\ directory. 


4. Make selections as follows: 


Advanced Installation of Communications Manager 


Target drive C 
e Install the default configuration file “ACSCFG’ 
¢ Select Additional features --> Utilities 


Note: Utilities are not part of the default configuration, so you should 
reinstall them at this time. 


e Press F3 to complete the process. 
¢ Be sure to update the CONFIG.SYS based on ‘ACSCFG’ only. 


5. Restart your workstation when prompted. 

6. Copy the ‘ACSCFG.CFG’ file in the C:\CMLIB directory into another file called 
TEAMxx (xx = team number from your tent card). This new configuration file 
will now be used during the remainder of this LAB. 


7. Carry on with the next section of this lab. 
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Topic 4.2. Creating 3270 Token-Ring Profiles 


Now, you will create the 3270 Token-Ring profiles. 


1. 


10. 


11. 


12. 


13. 


14. 


Start the Communications Manager using the TEAMxx configuration file just 
created. 


. Choose Advanced Configuration 


. Choose 3270 Feature Profiles 


Choose Token-Ring or other LAN type--> Create 
Connection 

Adapter 0 

Destination Address = 400009103689 

Session 1 

Terminal 

ID/LU Name = TRMOD2 

LU Address = 02 

Press the Enter key to accept all other defaults. 

F3 back to Communications Manager configuration menu. 


Carry on with the next section of this lab. 


¢ Use the help panels and/or the /BM Extended Services for OS/2 Communications 
Manager Configuration Guide, SO4G-1001 if you need help on a field. 
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Topic 4.3. SNA Data Link Control and Local Node Characteristics 


Because you will be doing SNA communications, you will need to configure the 
Token-Ring Data Link Control profiles. There is also some information in the Local 
Node Characteristics that will need to be set in order to establish the connection with 
the host. 


1. Choose SNA Feature Profiles--> Data Link Control (DLC) profiles. 

2. Choose Token-Ring or other LAN type 

3. Make sure that Create is highlighted. and press Enter. 

4. Use the /BM Extended Services for OS/2 Communications Manager Host Con- 
nection Reference, S04G-1004 and appendix A of this lab book to fill in the 
appropriate information here. 

¢ You will want to have at least 15 link stations to get you through all of the 
labs this week. Change it now. 
¢ Don’t reserve any links stations for incoming connections. 


e Set C&SM LAN ID = CANEDES 


Remember: The RU size just needs to be large enough, it does not need to 
match the host. You probably do not need to change it. See MAXDATA 
parameter in appendix B. 


5. Next, choose SNA Network definitions-- > Create 
Note: Don’t be alarmed when the PM desktop appears. 

6. Choose Local Node Characteristics. 

7. Use the /BM Extended Services for OS/2 Communications Manager Host Con- 
nection Reference, S04G-1004 and appendix A of this lab book to fill in the fol- 


lowing fields. 


e Network ID 
¢ Local Node Name 
¢ Local Node ID 


8. The rest of the fields do not matter for 3270 emulation. When you are finished, 
click on Save and Return. 


9. When the SNA Network Definition Selection dialog appears, click on Exit. 


__ 10. You are done with SNA configuration, so press [F3] to return to the Communi- 
cations Manager Configuration Menu. 


11. Carry on with the next section of this lab. 
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Topic 4.4, LAN Adapter and Protocol Support 


In order to use the Token-Ring LAN, for 3270 emulation, you need to install the Token- 
Ring adapter and IEEE 802.2 protocol support. 
1. Choose LAN Adapter and Protocol Support 


Note: Don’t be alarmed when the PM desktop appears. 
2. Choose Configure Workstation 


3. Choose IBM Token-Ring Network Adapters from the Network Adapters list, 
then click on Add. 
4. Choose IBM IEEE 802.2 from the Protocols list, then click on Add. 


Note: This sets up adapter 0 as a Token-Ring adapter that can send/receive 
IEEE 802.2 protocol data. There are some changes that need to be made 
though. 


5. Click on, IBM Token-Ring Network Adapters in the Current Configuration list, 
then click on Edit 


e You don’t need to change anything here, but look at some of the parame- 
ters. 
e¢ Click on Cancel when you are through looking. 


6. Now, click on, IBM IEEE 802.2 in the Current Configuration list, then click on 
Edit 


e You need to set your Network Adapter Address. Your address is listed in 
appendix A of this lab book. 


Note: You need to put a T in front of the address. The T stands for Token- 
Ring. Press [F1] while the cursor is on a field for more information on that 
field. 


¢ Make sure that you have at least as many link stations here as you did in 
the Token-Ring DLC profile. 


e Click on OK when you are through. 


7. When you return to the Configure Workstation dialog, click on OK because you 
are done now. 


8. When you return to the Options dialog, make sure that Configuration Complete 
is selected and click on OK. 


9. Verify the configuration file. 


Note: Read the messages in the message log. 


__ 10. Carry on with the next section of this lab. 
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Topic 4.5. Install and Test 


Now that configuration is done, you need to run REINST to get the code, for the new 
features, installed on the hard drive. 


Ts 
2: 


ae WA: 


gis V4 
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Exit the Communications Manager completely. 


Execute the REINST program and choose Communications Manager at the 
install/remove menu. 


This time, you will need to install a user configuration file. 


The file is in the [eeayeyiBa:3 directory. 


Select TEAMxx. 


IMPORTANT: By now, you should be getting the idea of how often REINST 
needs to be run (ie. every time you add a new feature). 


. When you are asked which config file to update the config.sys with, select 


TEAMxx 


When the ‘Select F3=Exit to install features’ pop-up appears, press F3 to 
install the features from the selected configuration file. 


. When the Restart System panel appears, reboot your system by pressing 


[Ctri+ Alt+ Del]. Why do you need to do this? 


. Start your Token-Ring session to see if it works. 


¢ Choose Start Emulators from the Communications Manager Main Menu. 
¢ Choose 3270 terminal emulation (non-DFT). 


e Choose All. 


If all goes well, you should have a 3270 session on your screen. 


. This concludes the Advanced Configuration lab. 
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Lab 5. Communications Manager LEN Node 
Configuration and Use 


What This Unit is About 


During this lab, you will get a chance to configure your workstation 
to use the LU 6.2 and T2.1 node capabilities to communicate on a 
peer to peer basis to partner systems. You will be configuring 
SNA local node characteristics, LEN connections, Partner LU pro- 
files, and transaction program profiles. Once the configuration is 
complete, you will run an APPC program and communicate with an 
APPC program on a remote system. 


This LAB will be used primarily to compare with the next labs to 
discover how APPN support enhances and simplifies the config- 
uration of Communications Manager for LU 6.2 communications. 


What You Should Be Able to Do 


After completing this unit, you should be able to 


¢ Configure Communications Manager Local Node Character- 
istics. 


Configure Communications Manager LEN node connections to 
other Communications Manager workstations. 


¢ Configure Partner LU profiles for remote partners. 


¢ Create an APPC Transaction Program Definition. 


Run an APPC Program and successfully communicate with a 
remote APPC program. 


Required Materials 


You will need the following materials to complete this lab: 


¢ This lab guide. 
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Topic 5.1. Communications Manager LEN Node Configuration 


Note: 


Configure to 1 partner only for a start. When you have that working, team up 


with another partner, add them and so on. The objective is to try and get everyone in 
the lab talking to everyone else. 


1. 


“2: 


5-2 


Communications Manager 


Make sure that you are configuring the TEAMxx file. 


LEN Node configuration is done under the SNA Feature Profiles configuration 
menu item. 


Choose SNA Network Definitions--> Create/Change. 


Choose Local Node Characteristics and make sure that the following values 
are set correctly. 


¢ Get your Network ID and Local Node Name from Appendix A of this LAB 
book. 
e You should be an End Node - No Network Server. 


e Make your Local Node Alias §paibeg, where xx = your team number. 
This is easier to remember than your real Node name. 


Note: Be sure to use all upper case for the alias name because the 
program you are going to be running only allows uppercase aliases. This 
is not a Communications Manager restriction, just this particular APPC 
program. 


When you are finished with the Local Node Characteristics, choose Con- 
nections from the SNA Network Definitions panel. 


You will be creating connections To Peer Nodes. They should have the fol- 
lowing characteristics: 


¢ The DLC is Token-Ring 


e¢ The Partner network ID is Pays . 


¢ Get your partner node names from Appendix A of this LAB book. 
e Get the LAN destination addresses from Appendix A of this LAB book. 


Use the comment line to identify the remote node. 
Define a LINK and PARTNER LU for each partner. 


Note: Configure to one partner only first. You will add other links and 
partners later. 


— The LU you will talk to at the partner system is their CP LU session. 
This LU has the same name as their control point. 


— For an alias, use something that easily identifies the partner LU. For 
example, you could use TEAMxx, where xx = the partner systems team 
number. 
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Note: Be sure to use all upper case for the alias name because the 
program you are going to be running only allows uppercase aliases. 
This is not a Communications Manager restriction, just this particular 
APPC program. 


Make sure that you click on Add. Don’t just press enter or the LU will 
not be added to the list. If you make a mistake during entry, you can 
click on the bad entry and then click on Change. 


7. When you have created all of your connections, choose: Configuration--> 
Additional SNA Features from the action bar. 


8. You need to create a Transaction Program Definition. This TP definition will 
be used to start an APPC server program that will be executed when an 
incoming attach comes from an APPC requester program. The definition 
should have the following characteristics: 


¢ The TP name that the requester program will send across on the attach is 
APPCSRV # 


Note: Don’t forget, this is case sensitive. 


¢ The APPC server program is called Bide VMatg. it is in the fae pyrs) 
directory. 


e On the parameter line, you should type the message that you would like to 
have sent to a requester that contacts your server. This message can be 
up to 100 characters long. 


¢ The APPC server program is a VIO_Windowable program and should be 
run as Non-queued, Attach Manager started. 


9. When you are done, the File pull down will allow you to Save and exit. 
10. When you return to the SNA Network Definitions panel, click on Exit. 
11. Verify your configuration file. 

12. If you need to, exit Communications Manager and restart it. 


__ 13. Carry on with the next section of this lab. 


© Copyright IBM Corp. 1992 Lab 5. Communications Manager LEN Node Configuration and Use 5-3 


Lab Notebook 





Topic 5.2. Run The APPC Requester Program 

The requester end of these two transaction programs is called APPCREQ.EXE. This 
program will send an attach command to the user specified server destination. The 
Attach Manager at that destination will execute the APPC server program and the 
server will send a message to the requestor. 

The requestor program is located in the C:\S7049 subdirectory. 

1. Run the the APPC Requester program. 

2. Select APPC from the action bar. 

3. Choose Set APPC parameters 

4. Use your CP LU alias in the LU alias field. 


5. Specify one of your partner LU aliases created during Communications 
Manager configuration in the Partner LU alias field. 


6. Use the mode Eagag . 


Note: You don’t need to worry about the conversation security values for this 
lab, so just leave them blank. You will use them in a later lab. 


7. Now you need to enter the message you wish to send to the server program. 
8. Select Message from the action bar. 
9. Choose Message to send 


10. Enter any message, up to 100 characters in length. Be sure to include your 
team number so the server can tell where the message came from. 


11. Now you are ready to send the message to the server. 

__ 12. Select Send from the action bar. 

13. Choose Send message 

14. lf everything is configured correctly, you will get a message back from the 


server program. If not, check your APPC parameters, change them, if neces- 
sary, and retry. 


Note: It you stop Communications Manager it will also be necessary to stop 
the APPC program before you will be able to start Communications Manager 
again. If you get a big red screen that says Communications Manager is 
already running, you have probably forgotten to stop the APPC program. 


15. Send a message to all of your configured partners to make sure it works. 


5-4 Communications Manager © Copyright IBM Corp. 1992 


Lab Notebook 


__ 16. Send a message to your own server by using your CP LU alias as the partner 
LU alias. 
Note: Each time you send a message, a thread is started. When the message 
has been sent, the thread ends. You are allowed to have three threads active 
at one time. A message displays, telling you the number of active threads. 
You can send messages as long as there are three or fewer active threads. 


__ 17. Use Subsystem Management to display your session status. Subsystem Man- 
agement can be accessed from the Communications Manager Main Menu 
Advanced pull down. 


Note: There will be more coverage of Subsystem Management in a later lab. 
18. When you have been able to successfully send/receive messages with one 


partner, go back.and add more links and partner LUs to your profiles until you 
can communicate with everyone in the room. 
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Lab 6. Communications Manager APPN Configuration 


and Use 


What This Unit is About 


In this lab, you are going to actually set up a small APPN network. 
The lab systems will be divided up into teams. One system will be 
the network node and the other systems will be end nodes. Once 
each team has their individual networks working, you will connect 
the network nodes together creating one large APPN network. 
When this network is complete, you will be able to easily commu- 
nicate with any other system in the room. 


The amount of configuration required for this lab should be com- 
pared to that required of the first lab. Configuration gets easier 
when you have APPN to do the work for you. The next lab will 
demonstrate even more of the discovery capabilities of APPN. 


What You Should Be Able to Do 


After completing this unit, you should be able to 


Required Materials 


Configure Communications Manager End nodes. 
Configure Communications Manager Network nodes. 
Configure Partner LU profiles for remote partners. 


Configure connections from the end nodes to the network node 
and vise versa. 


Run an APPC Program and successfully communicate with a 
remote APPC program. 


Connect multiple network nodes together into a large APPN 
network. 


You will need the following materials to complete this lab: 


e This lab guide. 
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Topic 6.1. End Node Configuration 


Complete this topic if you are an end node in your network. If you are a network 
node, go to the next topic. 


1. As preparation for this lab, you should delete all the connections that you 
created in the previous lab. 


Note: To see the connections, just click on the [+] sign next to the To Peer 
Node menu item. To delete a connection, just select it with the mouse and 
then press the Delete key. 


2. In order to act as an end node in an APPN network, you need to first modify 
your SNA Local node definitions. You can get to local node definitions quickly 
by choosing it from the Configuration pull down of the connections panel. 


e Your node type is now an End Node to Network Node Server. 


¢ Set the network node server address to your designated network node’s 
Token-Ring Address. 


3. This will automatically create a link to your network node. When you return to 
the connections panel, double click on this new connection to see what is 
looks like. 


Note: You will need to use the [+ ] sign to see the connection. 


4. When you deleted the connections to your peer nodes, you also deleted the 
partner LUs that were associated with that link. For now, you still need to 
have a partner LU description for each partner you wish to talk to. To create 
these, select Additional SNA Features from the Configuration pull down of the 
connections panel. 


5. Create the same partner LUs that you had during the previous lab. 


¢ Don’t worry about conversation security for now. 


e Use the comment field to identify the partner. 


Note: Remember that a fully qualified LU name is: Network ID.LU Name i.e. 
CANEDES.OVTNEA. Also, be sure to use all upper case for the alias name 
because the program you are going to be running only allows uppercase 
aliases. This is not a Communications Manager restriction, just this particular 
APPC program. 


Notice that you do not need to specify any link information for the partner LUs 
this time. The network node will take care of finding the best path to the 
remote control point. 


6. Make sure to do a Save and Exit of your SNA changes. 


6-2 Communications Manager : © Copyright IBM Corp. 1992 


Lab Notebook 





7. Verify the configuration file, exit Communications Manager, and restart it. 
Since you changed you Local node definitions, the dynamic update feature will 


not work. 
8. You are now ready to be an end node. 


9. Carry on with the “Run the APPC Requester Program’ Lab 








© Copyright IBM Corp. 1992 Lab 6. Communications Manager APPN Configuration and Use 6-3 


Lab Notebook 





Topic 6.2. Network Node Configuration 


Complete this topic if you are the network node in your network. If you are an end 
node, go to the next topic. 


1. As preparation for this lab, you should delete all the connections that you 
created in the previous lab. 


Note: To see the connections, just click on the [+] sign next to the To Peer 
Node menu item. To delete a connection, just select it with the mouse and 
then press the Delete key. 


2. In order to act as a network node in an APPN network, you need to first modify 
your SNA Local node definitions. You can get to local node definitions quickly 
by choosing it from the Configuration pull down of the connections panel. 


¢ Your node type is now a Network Node. 


3. You will need to create new connections. The connections will be To End 
Nodes this time. Create connections for the same systems as the previous 
lab. 


Note: Notice that you do not need to specify any partner LUs this time. The 
partner LUs are not directly associated with a particular link any more. This 
only describes a link to a control point. 


4. When you deleted the connections to your peer nodes, you also deleted the 
partner LUs that were associated with that link. For now, you still need to 
have a partner LU description for each partner you wish to talk to. To create 
these, select Additional SNA Features from the Configuration pull down of the 
connections panel. 


5. Create the same partner LUs that you had during the previous lab. 


¢ Don’t worry about conversation security for now. 
e Use the comment field to identify the partner. 


Note: Be sure to use all upper case for the alias name because the 
program you are going to be running only allows uppercase aliases. This 
is not a Communications Manager restriction, just this particular APPC 
program. 


Note: Notice that you do not need to specify any link information for the 
partner LUs this time. The network node will take care of finding the best path 
to the remote control point. 


6. Make sure to do a Save and Exit of your SNA changes. 
7. Verify the configuration file, exit Communications Manager, and restart it. 


Since you changed you Local node definitions, the dynamic update feature will 
not work. 
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8. You are now ready to be a network node. 


9. Carry on with the ‘Run the APPC Requester Program’ Lab 
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Topic 6.3. Run The APPC Requester Program 


6-6 


he 


2. 


3. 


4. 


Run the APPC requester program again. 
Send a message to all your configured partners to make sure it works. 


Send a message to your own server by using your CP LU alias as the partner 
LU alias. 


Use Subsystem Management to display your sessions. 


Do you notice any differences in the number of session compared to the last lab? 


5. Use the Display SNA Configuration tool, under Subsystem Management to 


observe additional information about your APPN network. There will be more 
on this tool later. 
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Topic 6.4, Connecting The Network Nodes. 


Now that your network is up and running, the next step is to combine all of the teams 
into one big APPN network. This is done by creating links between the network 
nodes. There are several ways to connect the network nodes. They could all have 
links to each other or, they could be linked together in a circle. The combinations are 
numerous. All that is really necessary is that each network node must have some 
path by which it can get to all the other network nodes. Refer to Appendix D in this 
guide for your network layout. 


1. In order to create this connection, each network node will need to create two 
connections To Network Nodes See the diagram in Appendix D of this lab 
book to determine the connections that should be made. 


2. Use the information in Appendix A of this lab book for the valid LAN 
addresses for your connections. 


3. When your connections are made, verify the configuration file. Use the 
dynamic update feature this time. 


4. Once all of the network nodes have connected, each system should get 
together with another system, on a different team, and set up the two system 
to talk to each other. 


Note: This will require nothing more than another partner LU definition. 
5. When you are ready, try to send a message to this new system. 
* Were the two LUs able to connect? 


6. If not, check to be sure that all of the network nodes were done with their con- 
nections, check your new partner LU definition, and try again. 
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Lab 7. Advanced APPN Topics 


What This Unit is About 


During this lab, you are going to experiment with some of the 
advanced features available for APPN in Communications 
Manager. The first part of this lab will involve security. You will 
get a chance to try the various security features provided for LU 
6.2 communications. Next, you will get a chance to see the 
various ways of executing a transaction program by experimenting 
with the transaction program definitions. Finally, you are going to 
edit your NDF file to include support for implicit inbound partner 
LUs and connections networks. You will then configure the trans- 
action program defaults so that you do not need to explicitly 
define all of your TPs. Next, you will run some APPC programs to 
test these new settings. 


What You Should Be Able to Do 


After completing this unit, you should be able to 
e Edit a Communications Manager NDF file. 
¢ Configure a connection network. 
¢ Configure support for implicit inbound partner LUs. 
e Configure transaction program defaults. 


e Use the security features provided for APPN communications. 


Required Materials 


You will need the following materials to complete this lab: 


e This lab guide. 
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Topic 7.1. Using Session Level Security 


In order to properly test the session level security, you will need to work with your 
partner team. Remember, session security does not work with implicit partners. 


se 


oo 


* Are you able to communicate with your partner? 


Session security is configured under the Additional SNA features section of 
SNA Network Definitions. It will be called LU to LU Security. 


Set up session level security for your partner team. Do not tell your partner 
the password that you are using. 


Verify Communications Manager. Use the dynamic update feature. 


Each team should now try to run the APPC requester program to the partner 
team. (APPCREQ) 





* Is the error message that is returned what you expected? 


* Why did this particular error occur? 





Now go back and make sure that the password is the same value at both ends 
of the session. 


Note: The password is case sensitive. 
Verify Communications Manager. Use the dynamic update feature. 


Each team should now try to run the APPC requester program to the partner 
team. (APPCREQ) 


* Are you able to communicate with your partner now? 


8. 


7-2 


lf you are able to communicate with your partner, move to the next topic. If 
not, double check your passwords and retry. 
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Topic 7.2. Using Conversation Level Security 


In order to properly test the conversation level security, you will need to work with 
your partner team. 


1. Change your transaction program definition for the APPCSRV program so that 
conversation security is required for the program. Now select Coversational 
Security (from Additional SNA Features) and enter a USERID and PASSWORD 
without telling the requester team what they are. 

2. Verify Communications Manager. Use the dynamic update feature. 

3. Each team should now try to run the APPC requester program to the partner 
team. (APPCREQ) This time. you need to put a USERID and PASSWORD into 


the respective fields of the APPCREQ program. Since you do not know your 
userid and password, just put any value here. 


* Are you able to communicate with your partner? 
i. Is the error message that is returned what you expected? 


* Why did this particular error occur? 


4. The server should now tell the requester the correct USERID and PASSWORD. 


5. Change the Conversation Security fields in the APPCREQ program to the 
correct values. 


6. Try the requester again with the correct values. 
* Are you able to communicate with your partner now? 


Note: Once you have conversation security working, lets use UPM to store 
the USERID and PASSWORD in the server. 


7. Change your conversation security profile. 


¢ Delete all USERIDs and PASSWORDs you have added to the profile. 
e Check the box that says to Utilize User Profile Management. 


Note: This tells conversation security to check UPM for USERIDs and 
PASSWORDs. 


8. Verify Communications Manager. Use the dynamic update feature. 
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13. 


14. 
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16. 


17. 


18. 








Open the User Profile Management group from the Desktop. 
Double click on the User Profile Management program 


When prompted to logon, use: 


¢ USERID = [GID] 


¢ PASSWORD = QSSvity 
Select Manage from the action bar and then select Manage users 
Double click on New to add a new user. 


Enter a USERID and a PASSWORD. 


Note: You need to type the password twice. 
Click on OK to finish. 
Close the UPM program. 


The server should now supply the correct USERID and PASSWORD to the 
requester. 


Each team should now try to run the APPC requester program to the partner 
team. (APPCREQ) 


* Are you able to communicate with your partner now? 


19. 


20. 


7-4 


If you are able to communicate with your partner, move to the next topic. If 
not, double check your userids and passwords and retry. 


Remove session level security and conversational level security before pro- 
ceeding with the next topic. 


Note: You will need to make 3 changes under Additional SNA Features to 
remove the security. Refer to the previous 2 topics. 
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Topic 7.3. Changing Transaction Program Operation 


In this section, you will get a chance to see some of the various ways of starting the 
executable file associated with a transaction program definition. The programs 
execute fast enough that you really won’t be able to tell the difference between 
queued and non-queued. You will be able to tell the difference between attach 
manager started vs. operator started vs. pre-loaded. 


1. Go back to configuration and change your Transaction Program definition for 
APPCSRV. 


2. Change the TP operation parameter to Queued, operator started 
3. Verify Communications Manager. Use the dynamic update feature. 
4. Have your partner run the requester program (APPCREQ) to your server. 


What happens? 


Note: When prompted, start the server as you would any OS/2 program. 
Remember to put your names as command line parameters or the requester 
won't know it is you. 


C:\S7049\APPCSRV.EXE Hi, This is the server at TEAMxx 


* What happens to the requester if you try to send a message to the server twice in 
succession? 








7 Is this what you expected to happen ? 
5. Repeat the exercise using Queued, operator preloaded. 


* What is the difference here? 


© Copyright IBM Corp. 1992 Lab 7. Advanced APPN Topics 7-5 


Lab Notebook 


Topic 7.4, Editing The NDF For Implicit LUs and Connection 
Networks 

In this section you will first edit your Network Definition File to support implicit 
inbound LUs. You will further modify your NDF to support connection networks. 
Finally you will run a transaction program between a number of partners, which will 


show you the benefits of implicit PLUs and connection networks in an APPN environ- 
ment. 


1. Use one of the editors to edit the file C:\CMLIB\APPN\TEAMxx.NDF 


e Make sure that the DEFINE_DEFAULTS verb has the parameter 
IMPLICIT_INBOUND_PLU_SUPPORT set to YES. . 


Remove all partner LU definition. 


¢ Make sure that the DIRECTORY_FOR_INBOUND_ATTACHES is set to *. 
This will cause the entire PATH statement to be searched. 


Note: This can be done from the PM panels as well, but it will be faster to 
change it here. 


e Add the verb for a connection network to the end of the file. Use the 
values specified in the example below. 


DEFINE CONNECTION NETWORK 
FQ_CN_NAME(CANEDES.CLSROOM) 
ADAPTER_INFO(DLC_NAME(IBMTRNET) ADAPTER_NUMBER(Q) ) ; 


2. Once you have made the changes, save the file. 


3. You now need to verify the file to make sure there are no errors. Use the 
verify program in the Communications Manager group to verify the file. It is 
called Verify SNA Network Definitions. Alternatively, you can run the APPNV 
program from an OS/2 command line to verify your NDF file. (If you use 
APPNV, use the /e option for dynamic update). 


4. If verification completes without error, you are ready to try it out. 

5. If Communications Manager is running, stop it. 

6. Start Communications Manager. 

7. There is a program called APPCTELL in the C:\S7049 directory. You can use 
this program to send a message (just like tell on VM) to another LU. All you 


need to do is specify the fully qualified partner LU that you want to send the 
message to, and the message you want to send. For example: 


APPCTELL CANEDES.USER45 Time to go home 
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8. Try to send a message to some other systems. As everyone finishes the mod- 
ifications to their NDF files, you will be able to contact everyone on the lab 
without explicitly defining any partner LU definitions. 


9. One thing that you probably won’t notice is that you should now be using the 
connection network to get to the other system. This is totally transparent to 
the user so you don’t really know it is happening. 


10. If you use the Display SNA Configuration tool, you can verify that you actually 
have a connection network, and that you are taking advantage of it. 


11. Another way to see the connection network in action is to display your SNA 
links. You should see implicit links to the systems you sent a message to. 


© Copyright IBM Corp. 1992 Lab 7. Advanced APPN Topics 7-7 


Lab Notebook 





7-8 Communications Manager 


© Copyright IBM Corp. 1992 





a 


| 


- 


= 


Lab Notebook 


Lab 8. 5250 Work Station Feature 


What This Unit is About 


During this lab, you will configure your TEAMxx file to include 
support for the 5250 Work Station Feature. You will be using the 
Advanced Configuration of Communications Manager because 
BCS will not let you change your TEAMxx file. Once you have your 
5250 terminals working, you will set up a logon profile to automate 
the conversation security checking that is done between the LU 
sessions. Finally, you will do some parameter matching between 
OS/400 and Communications Manager. 


What You Should Be Able to Do 

After completing this unit, you should be able to 
¢ Configure links to the AS/400 system. 
¢ Configure Partner LU profiles for the AS/400. 
¢ Configure 5250 terminal profiles. 
¢ Connect to an AS/400 host. 
¢ Create a UPM logon profile. 
¢ Find the required AS/400 matching parameters. 


Required Materials 


You will need the following materials to complete this lab: 


¢ This lab guide. 
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Topic 8.1. Configure Links and PLU profiles 


In this topic, you will create a link to an AS/400 host system. You will also define and 
associate a partner LU profile for this link. You must define a partner LU profile for 
the AS/400 because the 5250 Work Station Feature uses aliases. 


1. 


From the Communications Manager Main Menu, choose Advanced--> Config- 
uration 


Configure your TEAMxx 


Choose SNA Feature Profiles--> SNA network definitions--> Create/Change 


Configure Connection 


lf your system is configured as a Network Node, you will be creating links to a 
LEN Node. If your system is an End Node, you will be creating links to a Peer 
Node. 


Create the following link to the AS/400: 


Token-Ring DLC. (IBMTRNET) 

Use the default link name. LINKO00x (Just a name that is assigned) 
The Partner network ID is a . 

The Partner node name is | EDUC4O0 I 

The AS/400’s Token-Ring address is | 4000030116B5 & 

Use any comment you wish. 

Define a partner LU for the link: 

— The LU name is rey) . 


— The Alias is BPAyJii 


Note: You do not need to create an LU profile, because you can just use 
the CP LU that is automatically created. 


7. Save all the changes and return to the Communication Configuration Menu. 


8. Carry on with the next section of this lab. 
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Topic 8.2. Creating 5250 Work Station Feature Profiles 


In this topic, you will setup the profiles that are necessary for the 5250 Work Station 
Feature. You will create two terminal profiles. One will be for an auto-logon terminal, 
and the other will be for a manual logon terminal. You will create a printer profile so 
that a printer can be defined. Finally, you will set up the actual 5250 sessions. 


1. Choose 5250 Work Station Feature profiles 
2. Create a Terminal profile called [iAWgaii. Use the supplied model as a base. 


3. Look at the various items that can be changed. You do not need to change 
anything for this manual logon profile. When you are done looking, press 
(Pah. 


Note: You will need to at least choose Common terminal options and press 
Enter. You do not need to change anything on the common terminal options 
screens, just press enter twice, then press [F3 ] 


4. Create another Terminal profile called EV . 
5. Choose the Common terminal options. 
6. On the second page, change the Auto-signon parameter to Yes. 


7. Now create a Printer profile called §giauiugaig. Use the supplied model as a 
base. 


8. Look at the various items that can be changed. You do not need to change 
anything for this printer profile. When you are done looking, press [F3]. 
Note: You will need to at least choose Common printer options and press 
Enter. You do not actually need to change anything. 


9. The next step is to identify the LU that you will be using for your 5250 Work 
Station Feature sessions. Choose Specify APPC LU alias 


10. The alias you should use is the alias for your CP LU session. It should be 
aie@ You can use [F4] for a list. 


11. Now you will actually set up the sessions. Use the following information: 


¢ Session 1 
— Use your auto logon terminal profile (AUTOTERM). 
— This will be the first session on the AS/400 system. 
Use the mode. 
— Use the default Short session ID. 


e Session 2 


© Copyright IBM Corp. 1992 Lab 8. 5250 Work Station Feature 8-3 


Lab Notebook 


— Use your manual logon terminal profile (MANTERM). 
— This will be the second session on the AS/400 system. 
— Use the mode. 
— Use the default Short session ID. 
¢ Session 3 
— Use your printer profile (PRINTER). 
— This will be the third session on the AS/400 system. 
— Use the mode. 
— Use the default Short session ID. 
__ 12. Verify your configuration file, and exit the Communications Manager. 
13. Check your message log for a REINST message. If a REINST is required, 
select NETxx and TEAMxx configuration files for all updates but select TEAMxx 


as your active configuration. 


14. Carry on with the next section of this lab. 
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Topic 8.3. Using the 5250 Work Station Feature 


In this topic, you will actually use the 5250 Work Station Feature. 

1. Start Communications Manager. 

2. Select Start emulators 

3. Start all of your 5250 Work Station Feature sessions. 

4. When you are prompted, enter your AS/400 userid and Password.. Use 


OS2!1Dxx for both the userid and password. 


Note: As your sessions start, you should notice that you will be automatically 
logged on to your first session. You will still need to manually log on to the 
second session. The UPM panel does not actually log you on to the host, it is 
only for checking conversation security on the sessions. 


5. All of your sessions will exist within the same window. Jump between the ses- 
sions using the Alt+ Page up key. 


6. Using the first session, send a message to the instructor ID, OS2IDOO, to verify 
that you have connected. To send a message: 
¢ Select User Tasks. 
¢ Select Send a message. 
¢ Type in your text. 
e Put OS21D00 in the To user profile field. 
¢ Press Enter to send the message. 
Note: You will not receive any confirmation of the note being successfully 


sent. 


7. Carry on with the next section of this lab. 
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Topic 8.4. Customizing the 5250 Work Station Feature 


In this topic, you will make the 5250 Work Station Feature operate as a full screen 
application instead of a windowed application. You will also set up a UPM User 
Logon Profile. This profile will allow you to have logon entries for your remote node 
stored in memory when you log on locally. This will keep you from needing to enter 
your remote IDs for every session. 


1. Edit the file called C\CMLIB\STARTCM.CMD. 


2. Find the line that reads: 
SET EM5250=WIN 


3. Change it to: 
REM SET EM5250=WIN 
4. Save the file. 


Note: Now, the next time you start Communications Manager your 5250 Work 
Station Feature will run in a full screen. You will need to exit Communications 
Manager completely for this to work. 


5. In order to create a UPM User Logon Profile, go to the UPM group under pres- 
entation manager. 


6. Select User Profile Management. 


7. When prompted, log on as | USERID | with a password of [ASST . 


8. Select Actions--> Add/Change user logon profile. 
9. Make sure that NEW is highlighted. 
__ 10. Select Actions--> Add new entry 


__ 11. Enter your AS/400 userid and password. Use ESPLU as the remote node 
name (This is the alias of the partner LU at the AS/400). 


Note: Now, when you log on locally as USERID, you will have your AS/400 
userids and passwords added to your list of logons. This way, when you start 
the 5250 Work Station Feature, you will not be prompted for each of your 
AS/400 userids. 


__ 12. In order to test the new setup out, and prove it really works, shutdown and 
reboot your system. 


13. When your system comes up, before you start the Communications Manager, 
go to the UPM group and select logon. 


__ 14. logon as USERID | with a password of Pies. 
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15. Now start Communications Manager. 


16. Start all of your 5250 sessions. 


Note: You should notice two things: 
a. Your 5250 sessions should now be full screen instead of windowed. 


b. You shouldn’t have any UPM logon panel to fill out when the 5250 ses- 
sions come up. 


17. Carry on with the next section of this lab. 
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Topic 8.5. AS/400 Parameter Matching 


In order to use the 5250 Work Station Feature, several parameters must match 
between OS/400 on the AS/400 and Communications Manager on the Work Station. 
These parameters have different names on the two systems however. See if you can 
find the name of the OS/400 parameters that match up with the following Communi- 
cations Manager parameters: 


Use the following OS/400 commands to display configuration information on the 
AS/400: 


Network information DSPNETA 

Line information DSPLIND EDCLAN 

Controller information DSPCTLD(OVTNEx }~ Wie 

Mode information DSPMODD #INTER 

Device information DSPDEVD OVTNEx 

Communications Manager Parameter OS/400 Parameter 
Network ID 


Partner LU name 





Destination address 


Local APPC LU name DINE WD Remote 
Lecatiew 


Local node name OVINE —__ CUD Remorse cP 
Local LAN Address _ g 


Mode name — {vd 





Devie name = Local Po td 
] 
— C€4\ Wame 


t j|:,, 
line VLOWLE 
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Topic 8.6. Optional Challenge 


The end nodes should be able to remove all of their Peer connections and get to the 
AS/400s through the network nodes instead. 


Try it! 
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Lab 9. Subsystem Management 


What This Unit is About 


During this lab, you will get a chance to use several of the Com- 
munications Manager Subsystem Management tools. First, you 
will display information about your own system. Then, you will set 
up the systems in your network so that you can display informa- 
tion about another workstation in your network. Finally, you will 
get a chance to use the Service Point Application Router and the 
Remote Operations Service with NetView. 


What You Should Be Able to Do 


After completing this unit, you should be able to 


e Use the Communications Manager Subsystem Management 
tools to display configuration information. 


¢ Display a remote system’s SNA configuration. 


e Use the Service Point Application Router and Remote Oper- 
ations Service to issue commands to an OS/2 workstation. 


Required Materials 


You will need the following materials to complete this lab: 
e This lab guide. 
¢ Extended Services for OS/2 diskettes. 


e¢ NetView logon information given in class. 
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Topic 9.1. Subsystem Management 


The tools you are going to use for this topic can be accessed from the Communi- 
cations Manager main menu under Subsystem Management, or from the Communi- 
cations Manager applications group. Use whichever method you prefer. 


SNA Logical Links 


1. Make sure that Communications Manager is running. 

2. First, use the SNA Logical Link Services application to display information 
about your links. 
Note: All of your configured logical links will be displayed, along with their 
status. ; 


3. Use Options to change the font size. 


4. Use Change status to deactivate one of your links. 
Note: Use the Deactivate hard option. This will bring the link down imme- 
diately. 

5. Reactivate the link you just deactivated. 
Note: Use the [Ctri+R] key to refresh the display. You should see the status 
go from inactive to pending active to active. 


6. Double click on one of your active links to get more detailed information about 
the link. 


Display Active SNA Configuration 


9-2 


1. Start the Display Active SNA Configuration application. Using the Display pull 
down, display all of your General SNA and APPN information. 


Note: Display each item to see what is available to you. Use the help panel 
for additional information. 

How many LUs are in your directory? 

How many LUs registered with you? 


Do LUs register with an end node? 


How many LU 6.2 sessions do you have? 
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* How many CP-CP sessions do you have? 


Hint: The mode on a CP-CP session is CPSVCMG. 


Remote System SNA Configuration 


One on the nice things you can do with the Display Active SNA Configuration is 
display the configuration of a remote workstation. This requires a transaction 
program in the remote system. This program is called RDSPSRVR. The remote 
system can explicitly define a transaction program profile or, it can use the trans- 
action program defaults. This program was installed when the utilities were installed. 
The program is in the C:\CMLIB\DSPSVR directory. 


1. Edit your NDF file and change the default directory to C:\CMLIB\DSPSVR. 
2. Save and verify the configuration file. 


3. To display the configuration of another workstation, choose Options--> Select 
target. 


4. lf you are an end node, display your network node’s SNA configuration. 


Note: Compare the topology display for the network node to the topology of 
an end node. 


5. If you are the network node, display one of your end node’s configuration. 


Note: Compare the topology display for the network node to the topology of 
an end node. 


6. Display any other information you wish to see. 


7. Try to find some information about your system in the remote system’s config- 
uration. 


8. When you want to return to your own SNA configuration, you need to select 
yourself as the target. 


Other Tools 
1. Explore each of the items, that you have not already used, under the Commu- 


nications Manager Main Menu--> Advanced--> Subsystem Management 
option. 


Note: Use the help panels to get more information about each tool. 


2. Start one of your 3270 and one of your 5250 emulators. 
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* Do you have any transaction programs running? If so, what are they for? 


3. Now, try deactivating your Token-Ring DLC. 


* What happens to applications using that DLC? 


4. Try to re-activate your Token-Ring DLC. 


* Were you able to re-activate it? Why or why not? 





* Do all of your applications come back up when the DLC comes back up? 
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Topic 9.2. Service Point Application Router and Remote 
Operations Service 


The SPA Router and ROP Service allow you to issue commands to a remote OS/2 
workstation from a NetView console. In order to use this feature, it must first be 
installed and running on the OS/2 workstation. 
1. Insert the Extended Services for OS/2 disk 1 into your a drive. 
2. From an OS/2 command prompt, enter the command [RAW Ay. This will 
install the SPA Router and ROP Service. It will also create a new group called 
Remote Operations with the two applications in it. 


3. You will need to reboot the system and start Communications Manager before 
using the new tools. 


4. Open the Remote Operations group and start the two programs. 
Note: You need to start the SPA Router first. 


5. Your workstation is now ready to receive commands from a NetView console. 
6. Start a 3270 terminal session. 
7. Type in OVYNV on the command line of your 3270 session screen. 


8. Logon to Netview. Ask your instructor for your userid and password. 


Note: You may need to change the password, if it has expired. 
S. When you get the 7??? *** prompt, press enter. 
10. Enter [Qi at the NetView Main Menu. 


11. You can now send commands through NetView. The syntax is: 


RUNCMD SP=yyyyyyyy, APPL=REMOTEOP, OP=xxxxxxxx; PASS=zzzzzzzz; COMMAND 


Where: 
yyyyyyyy 


PU/Control Point you wish to send the command to 


XXXXXXXX = Your USERID. This will be check in the OS/2 UPM if such 
checking has been turned on. 


ZZzzzzzz = Your UPM password. If using UPM checking, this is 
required, if not, you can leave this parameter, and the 
semicolon that follows it, off. 


COMMAND = The command you wish to execute. For example: 
DIR C: 
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12. 


13. 


14. 


15. 


16. 


tf, 


18. 


19. 


20. 


21s 


22. 


23. 


24. 
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Try sending a command to your control point first. 


Note: Your control point ID can be found in Appendix A of this LAB guide. 


Now, try sending to another system that has the SPA Router and ROP Service 
running. 


Note: The [F12] key can be used in NetView to recall the previous command. 


There is a UPM userid called USERID and a password called PASSWORD that 
you can use if the remote system is using the UPM checking. 


Now, try using the UPM checking in your system. 
In the Remote Operations application, choose Options--> Program options 


Click on UPM operator checking. Now, only users in your UPM database can 
issue commands to your workstation. 


Try to send a command with an invalid userid/password. 

Now, try with a valid userid/password. 

Another nice feature is the ability to limit the commands that can be issued to 
the workstation. You can build a list of commands. This list can be a list of 
valid commands or a list of invalid commands. This is controlled by a check 


box that effects the entire list. 


To try this out, choose Options--> Edit command validation table from the 
ROP application. 


Add a command to the list. For example, your could add the DIR command. 
Now, if you want the list to contain all of the valid commands, you need to 
uncheck the Exclusive set check box. If the list is a list of invalid commands, 
leave the check box checked. 

Try it out each way with the command you entered into the list. 

Before finishing this lab, take a few moments to look at the other options that 


are available on the action bar of both the SPA Router and the ROP Service 
applications. 
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Lab 10. Problem Determination 


What This Unit is About 


During this lab, you will get a chance to use several of the Com- 
munications Manager problem determination tools. You will first 
look at each of the logging utilities available. Next, you will 
perform a trace of Communications Manager data and API calls. 
The trace will then be formatted for easier reading. Finally, you 
are going to use the problem determination tools and experience 
gained throughout the week to solve a communications problem. 


What You Should Be Able to Do 


After completing this unit, you should be able to 


e Use the Extended Services for OS/2 problem determination 
documentation to assist in problem determination. 


e Use the LANTRAN.LOG. 

e Use the Communications Manager message log. 
e Use the Communications Manager error log 

¢ Perform a Communications Manager trace. 


¢ Format a Communications Manager trace. 


Required Materials 


You will need the following materials to complete this lab: 
¢ This lab guide. 


e IBM Extended Services for OS/2 Problem Determination Guide 
for the Service Coordinator, S04G-1006 


e IBM Extended Services for OS/2 Programming Services and 
Advanced Problem Determination for Communications, 
$04G-1007 
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Topic 10.1. LANTRAN.LOG 


Whenever you run Communications Manager over a LAN, a file called LANTRAN.LOG 
is created,in the C:\IBMCOM directory, when the system is started. A service coordi- 
nator may want to look at this file as the first step in solving LAN problems. 


1. Open an OS/2 session, change to the C:\IBMCOM directory and view the 
LANTRAN.LOG file. The type command will work fine: 


TYPE LANTRAN.LOG 


2. Use the contents of the LANTRAN.LOG file to answer the following: 


¢ What kind of LAN are you on? 

¢ What data rate is it? 

e Which LAN adapter is it? 

e What is the LAN adapter address? 
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Topic 10.2. Message log and Error log 
1. Start Communications Manager if it is not already running. 


2. Go to the Communications Manager main menu and select Message from the 
action bar. 


* What is the default name of the message file? 


* Which Communications Manager configuration profile is used to set the default 
name of the message file? 


3. Put the cursor on the originator entry and press [F4] to display a list of pos- 
sible message originators. Scroll through the list of all possible originators. 


4. When you have finished looking at the originators, press the escape key to 
leave the entry blank. This will display all messages rather than restricting 
them to a particular originator. 


5. Pick one of your messages that have accumulated over the week. 

6. You can get help on the possible causes and recommended actions for an 
error by placing the cursor on the message number field of a message and 
pressing the [F1] key. The /BM Extended Services for OS/2 Problem Determi- 


nation Guide for the Service Coordinator, SO4G-1006 contains most of the 
message descriptions. 


7. Switch to an OS/2 session, change to the C:\CMLIB directory, and try to edit 
the MESSAGE.DAT file. 


* Can you edit it? 
8. Try to delete the file. 
Can you delete it? 


* Why Can’t you work with this file? Is there anything you could do that would 
allow you to work with it? 





9. Now, take a look at the Communications Manager error log. Go to 
Advanced--> Problem determination aids--> Error log services to display the 
error log. 
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* What is the default name of the error log file? 


* Which Communications Manager configuration profile is used to set the default 
name of the error log file? 


10. Note that you can use the Log type field to restrict the messages to a certain 
type. 


11. Try displaying all ALERTS that have been logged to the error log. The alert is 
an error type of 0017 


12. Now, display all of the error log entries. 


Note: The /BM Extended Services for OS/2 Programming Services and 
Advanced Problem Determinationfor Communications, S04G-1007 lists most of 
the possible errors and their type number. 


__ 13. Switch to an OS/2 session, change to the C:\CMLIB directory, and try to type 
the ERROR.DAT file. 
* Can you type it? 


* Why Can’t you type this file? 


* What do you do if you wish to print the error log? 
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Topic 10.3. Communications Manager Trace 
1. Use Communications Manager menus or the CMTRACE program to turn on 
traces for the APPC API and IBMTRNET data. 
Note: If you wish to use CMTRACE, you can get syntax help by typing 
‘CHTRACE.?| on the command line. 
2. Run the APPCREQ program to a server on the network. It doesn’t matter who. 


Note: If you send the message to your own server, you will see both ends of 
the conversation in the trace. This will look pretty confusing and will be diffi- 
cult to follow. 


3. After sending the message, stop the trace. 
4. Write the trace out to a file called C:\S7049\TRACE1.TRC 
5. Now, go to the C:\S7049 directory. 


6. Use the FMTTRACE program to format the TRACE1.TRC file. Make sure to 
create both a summary trace and a detailed trace. To do this, you need to use 
the /D parameter at the end of the command. This will cause two new files to 
be created, TRACE1.SUM and TRACE1.DET. 


Note: You can get syntax help for FMTTRACE by typing #gugiy aig on the 
command line. 


7. Use an editor to look at each of these files. If you are not familiar with trace 
data, the summary trace will be the most useful to you. From it, you can 
follow the flow of data that took place when the program was run. 


Note: Make sure that you use a monospaced font and turn word wrap off, or 
the traces will look funny. 
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Appendix A. Lab Setup for initial labs 


Destination Address: 400009103689 


Network ID: CANEDES 










































































































Wks Name LAN Address Local Node | Local 
Number (Local Name (CP Node ID 

Node Name) 

Alias) | 

TEAMO1 400000368122 OVTNEB 40077 
02 TEAMO2 400000368123 OVTNEC 40078 
03 TEAMO3 400000368124 “| OVTNED 40079 
04 TEAMO4 400000368125 OVTNEE 40080 
05 TEAM05 —_—|_- 400000368126 OVTNEF 40081 
06 TEAMO6 400000368127 OVTNEG 40082 
07 TEAMO7 400000368128 OVTNEH 40083 
08 TEAMO08 400000368129 40084 
09 TEAMO9 400000368130 OVTNEJ 40085 
10 TEAM10 | 400000368131 OVTNEK 40086 

TEAM11 400000368132 | OVTNEL 40087 
12 TEAM12 400000368133 ___ | OVTNEM 
400000368134 OVTNEN 40089 

14 TEAM14 400000368135 OVTNEO 40090 
15 TEAM15 400000368136 OVTNEP 40091 
16 TEAM16 400000368137 T OVTNEQ 40092 
17 TEAM17 400000368138 OVTNER 40093 
18 TEAM18 400000368139 OVTNES 40094 
19 TEAM19 | 400000368140 OVTNET 40095 
20 TEAM20 400000368141 OVTNEU | 40096 
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Appendix B. Host VTAM/NCP Information Sample 


VTAM Definitions for OS/2 EE Workstations 


INSTRUCT PU 


STUDxx01 LU 
STUDXx02 LU 
STUDxx03 LU 
STUDxx04 LU 
STUDxx05 LU 
STUDxx06 LU 
STUDxx07 LU 
STUDxx08 LU 
STUDxx09 LU 
STUDxxOA LU 
STUDxxOB LU 
STUDxx0C LU 
STUDxxOD LU 
STUDxxOE LU 
STUDxxOF LU 
STUDxx11 LU 
STUDxx12 LU 


ADDR=50, 
IDBLK=05D, 
I DNUM=000xx 
DISCNT=NO, 
ANS=CONT, 
IRETRY=YES, 
PUTYPE=2, 


MAXOUT=7, 
MODETAB=MOD 


FORO IIR RK OK 


* Workstation * 
MAXDATA=1010, * xXx = 


KKEKKAKKKKKAKKKKKKKAKKKK 


E3279, 


USSTAB=MSNF3279, 
SSCPFM=USSSCS. 


PACING=(1,1 
VPACING=(2, 


LOCADDR=02, 
LOCADDR=03, 
LOCADDR=04, 
LOCADDR=05, 
LOCADDR=06, 
LOCADDR=0/7, 
LOCADDR=08, 
LOCADDR=09, 
LOCADDR=10, 
LOCADDR=11, 
LOCADDR=12, 
LOCADDR=13, 
LOCADDR=14, 
LOCADDR=15, 
LOCADDR=16, 
LOCADDR=17, 
LOCADDR=18, 


)s 
1) 


ISTATUS=ACTIVE, 
ISTATUS=ACTIVE, 
ISTATUS=ACTIVE, 
ISTATUS=ACTIVE, 
ISTATUS=ACTIVE, 
ISTATUS=ACTIVE, 
ISTATUS=ACTIVE, 
ISTATUS=ACTIVE, 
ISTATUS=ACTIVE, 
ISTATUS=ACTIVE, 
ISTATUS=ACTIVE, 
ISTATUS=ACTIVE, 
ISTATUS=ACTIVE, 
ISTATUS=ACTIVE, 
ISTATUS=ACTIVE, 
ISTATUS=ACTIVE, 
ISTATUS=ACTIVE, 


team number * 


LOGAPPL=ESSAMON 
LOGAPPL=ESSAMON 
LOGAPPL=ESSAMON 
LOGAPPL=ESSAMON 
LOGAPPL=ESSAMON 
LOGAPPL=ESSAMON 
LOGAPPL=ESSAMON 
LOGAPPL=ESSAMON 
LOGAPPL=ESSAMON 
LOGAPPL=ESSAMON 
LOGAPPL=ESSAMON 
LOGAPPL=ESSAMON 
LOGAPPL=ESSAMON 
LOGAPPL=ESSAMON 
LOGAPPL=ESSAMON 
LOGAPPL=ESSAMON 
LOGAPPL=ESSAMON 


Note: The first two digits of the PSERVIC value in the MODETAB entry define the LUs 


to be of type 2. 
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More... 
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or 





3745 NCP Information 


TR21PGL4 LINE ADDRESS=(1093,FULL), 
LOCADD=400009103689, 
PORTADD=4, 
MAXTSL=1050, 
RCVBUFC=4095, 
ISTATUS=ACTIVE, 
ADAPTER=TIC2, 
TRSPEED=4 


Network Information 


Network Name CANEDES 
C&SMLANID CANEDES 
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